From fca04cc704592365ea6168ec026be767eae1e4ed Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Thu, 20 Jun 2019 10:10:25 -0700 Subject: [PATCH 01/13] Add docs configs for all APIs. --- .kokoro/docs/api_core.cfg | 7 +++++++ .kokoro/docs/asset.cfg | 7 +++++++ .kokoro/docs/automl.cfg | 7 +++++++ .kokoro/docs/bigquery.cfg | 7 +++++++ .kokoro/docs/bigquery_datatransfer.cfg | 7 +++++++ .kokoro/docs/bigquery_storage.cfg | 7 +++++++ .kokoro/docs/bigtable.cfg | 7 +++++++ .kokoro/docs/container.cfg | 7 +++++++ .kokoro/docs/containeranalysis.cfg | 7 +++++++ .kokoro/docs/core.cfg | 7 +++++++ .kokoro/docs/datacatalog.cfg | 7 +++++++ .kokoro/docs/datalabeling.cfg | 7 +++++++ .kokoro/docs/dataproc.cfg | 7 +++++++ .kokoro/docs/datastore.cfg | 7 +++++++ .kokoro/docs/dlp.cfg | 7 +++++++ .kokoro/docs/dns.cfg | 7 +++++++ .kokoro/docs/error_reporting.cfg | 7 +++++++ .kokoro/docs/firestore.cfg | 7 +++++++ .kokoro/docs/grafeas.cfg | 7 +++++++ .kokoro/docs/iam.cfg | 7 +++++++ .kokoro/docs/irm.cfg | 7 +++++++ .kokoro/docs/kms.cfg | 7 +++++++ .kokoro/docs/language.cfg | 7 +++++++ .kokoro/docs/logging.cfg | 7 +++++++ .kokoro/docs/monitoring.cfg | 7 +++++++ .kokoro/docs/oslogin.cfg | 7 +++++++ .kokoro/docs/phishingprotection.cfg | 7 +++++++ .kokoro/docs/pubsub.cfg | 7 +++++++ .kokoro/docs/redis.cfg | 7 +++++++ .kokoro/docs/resource_manager.cfg | 7 +++++++ .kokoro/docs/runtimeconfig.cfg | 7 +++++++ .kokoro/docs/scheduler.cfg | 7 +++++++ .kokoro/docs/securitycenter.cfg | 7 +++++++ .kokoro/docs/spanner.cfg | 7 +++++++ .kokoro/docs/speech.cfg | 7 +++++++ .kokoro/docs/storage.cfg | 7 +++++++ .kokoro/docs/talent.cfg | 7 +++++++ .kokoro/docs/tasks.cfg | 7 +++++++ .kokoro/docs/texttospeech.cfg | 7 +++++++ .kokoro/docs/trace.cfg | 7 +++++++ .kokoro/docs/translate.cfg | 7 +++++++ .kokoro/docs/videointelligence.cfg | 7 +++++++ .kokoro/docs/vision.cfg | 7 +++++++ .kokoro/docs/webrisk.cfg | 7 +++++++ .kokoro/docs/websecurityscanner.cfg | 7 +++++++ 45 files changed, 315 insertions(+) create mode 100644 .kokoro/docs/api_core.cfg create mode 100644 .kokoro/docs/asset.cfg create mode 100644 .kokoro/docs/automl.cfg create mode 100644 .kokoro/docs/bigquery.cfg create mode 100644 .kokoro/docs/bigquery_datatransfer.cfg create mode 100644 .kokoro/docs/bigquery_storage.cfg create mode 100644 .kokoro/docs/bigtable.cfg create mode 100644 .kokoro/docs/container.cfg create mode 100644 .kokoro/docs/containeranalysis.cfg create mode 100644 .kokoro/docs/core.cfg create mode 100644 .kokoro/docs/datacatalog.cfg create mode 100644 .kokoro/docs/datalabeling.cfg create mode 100644 .kokoro/docs/dataproc.cfg create mode 100644 .kokoro/docs/datastore.cfg create mode 100644 .kokoro/docs/dlp.cfg create mode 100644 .kokoro/docs/dns.cfg create mode 100644 .kokoro/docs/error_reporting.cfg create mode 100644 .kokoro/docs/firestore.cfg create mode 100644 .kokoro/docs/grafeas.cfg create mode 100644 .kokoro/docs/iam.cfg create mode 100644 .kokoro/docs/irm.cfg create mode 100644 .kokoro/docs/kms.cfg create mode 100644 .kokoro/docs/language.cfg create mode 100644 .kokoro/docs/logging.cfg create mode 100644 .kokoro/docs/monitoring.cfg create mode 100644 .kokoro/docs/oslogin.cfg create mode 100644 .kokoro/docs/phishingprotection.cfg create mode 100644 .kokoro/docs/pubsub.cfg create mode 100644 .kokoro/docs/redis.cfg create mode 100644 .kokoro/docs/resource_manager.cfg create mode 100644 .kokoro/docs/runtimeconfig.cfg create mode 100644 .kokoro/docs/scheduler.cfg create mode 100644 .kokoro/docs/securitycenter.cfg create mode 100644 .kokoro/docs/spanner.cfg create mode 100644 .kokoro/docs/speech.cfg create mode 100644 .kokoro/docs/storage.cfg create mode 100644 .kokoro/docs/talent.cfg create mode 100644 .kokoro/docs/tasks.cfg create mode 100644 .kokoro/docs/texttospeech.cfg create mode 100644 .kokoro/docs/trace.cfg create mode 100644 .kokoro/docs/translate.cfg create mode 100644 .kokoro/docs/videointelligence.cfg create mode 100644 .kokoro/docs/vision.cfg create mode 100644 .kokoro/docs/webrisk.cfg create mode 100644 .kokoro/docs/websecurityscanner.cfg 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/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/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" +} From 616bddcf7d51ed760a669567d586103f426512c1 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Thu, 20 Jun 2019 12:30:45 -0700 Subject: [PATCH 02/13] API repo-metadata files. --- .repo-metadata.json | 13 +++++++++++++ asset/.repo-metadata.json | 13 +++++++++++++ automl/.repo-metadata.json | 13 +++++++++++++ bigquery/.repo-metadata.json | 13 +++++++++++++ bigquery_datatransfer/.repo-metadata.json | 13 +++++++++++++ bigquery_storage/.repo-metadata.json | 13 +++++++++++++ bigtable/.repo-metadata.json | 14 ++++++++++++++ container/.repo-metadata.json | 14 ++++++++++++++ containeranalysis/.repo-metadata.json | 13 +++++++++++++ datacatalog/.repo-metadata.json | 13 +++++++++++++ datalabeling/.repo-metadata.json | 13 +++++++++++++ dataproc/.repo-metadata.json | 13 +++++++++++++ datastore/.repo-metadata.json | 12 ++++++++++++ dlp/.repo-metadata.json | 13 +++++++++++++ dns/.repo-metadata.json | 13 +++++++++++++ error_reporting/.repo-metadata.json | 13 +++++++++++++ firestore/.repo-metadata.json | 0 grafeas/.repo-metadata.json | 13 +++++++++++++ iam/.repo-metadata.json | 12 ++++++++++++ iot/.repo-metadata.json | 12 ++++++++++++ irm/.repo-metadata.json | 13 +++++++++++++ kms/.repo-metadata.json | 13 +++++++++++++ language/.repo-metadata.json | 13 +++++++++++++ logging/.repo-metadata.json | 12 ++++++++++++ monitoring/.repo-metadata.json | 0 oslogin/.repo-metadata.json | 13 +++++++++++++ phishingprotection/.repo-metadata.json | 13 +++++++++++++ pubsub/.repo-metadata.json | 13 +++++++++++++ redis/.repo-metadata.json | 13 +++++++++++++ resource_manager/.repo-metadata.json | 13 +++++++++++++ runtimeconfig/.repo-metadata.json | 13 +++++++++++++ scheduler/.repo-metadata.json | 13 +++++++++++++ securitycenter/.repo-metadata.json | 13 +++++++++++++ spanner/.repo-metadata.json | 13 +++++++++++++ speech/.repo-metadata.json | 13 +++++++++++++ storage/.repo-metadata.json | 13 +++++++++++++ talent/.repo-metadata.json | 13 +++++++++++++ tasks/.repo-metadata.json | 13 +++++++++++++ texttospeech/.repo-metadata.json | 13 +++++++++++++ trace/.repo-metadata.json | 13 +++++++++++++ translate/.repo-metadata.json | 13 +++++++++++++ videointelligence/.repo-metadata.json | 13 +++++++++++++ vision/.repo-metadata.json | 13 +++++++++++++ webrisk/.repo-metadata.json | 13 +++++++++++++ websecurityscanner/.repo-metadata.json | 13 +++++++++++++ 45 files changed, 557 insertions(+) create mode 100644 .repo-metadata.json create mode 100644 asset/.repo-metadata.json create mode 100644 automl/.repo-metadata.json create mode 100644 bigquery/.repo-metadata.json create mode 100644 bigquery_datatransfer/.repo-metadata.json create mode 100644 bigquery_storage/.repo-metadata.json create mode 100644 bigtable/.repo-metadata.json create mode 100644 container/.repo-metadata.json create mode 100644 containeranalysis/.repo-metadata.json create mode 100644 datacatalog/.repo-metadata.json create mode 100644 datalabeling/.repo-metadata.json create mode 100644 dataproc/.repo-metadata.json create mode 100644 datastore/.repo-metadata.json create mode 100644 dlp/.repo-metadata.json create mode 100644 dns/.repo-metadata.json create mode 100644 error_reporting/.repo-metadata.json create mode 100644 firestore/.repo-metadata.json create mode 100644 grafeas/.repo-metadata.json create mode 100644 iam/.repo-metadata.json create mode 100644 iot/.repo-metadata.json create mode 100644 irm/.repo-metadata.json create mode 100644 kms/.repo-metadata.json create mode 100644 language/.repo-metadata.json create mode 100644 logging/.repo-metadata.json create mode 100644 monitoring/.repo-metadata.json create mode 100644 oslogin/.repo-metadata.json create mode 100644 phishingprotection/.repo-metadata.json create mode 100644 pubsub/.repo-metadata.json create mode 100644 redis/.repo-metadata.json create mode 100644 resource_manager/.repo-metadata.json create mode 100644 runtimeconfig/.repo-metadata.json create mode 100644 scheduler/.repo-metadata.json create mode 100644 securitycenter/.repo-metadata.json create mode 100644 spanner/.repo-metadata.json create mode 100644 speech/.repo-metadata.json create mode 100644 storage/.repo-metadata.json create mode 100644 talent/.repo-metadata.json create mode 100644 tasks/.repo-metadata.json create mode 100644 texttospeech/.repo-metadata.json create mode 100644 trace/.repo-metadata.json create mode 100644 translate/.repo-metadata.json create mode 100644 videointelligence/.repo-metadata.json create mode 100644 vision/.repo-metadata.json create mode 100644 webrisk/.repo-metadata.json create mode 100644 websecurityscanner/.repo-metadata.json diff --git a/.repo-metadata.json b/.repo-metadata.json new file mode 100644 index 000000000000..0e9078fe76f2 --- /dev/null +++ b/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "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", + "requires_billing": true +} \ No newline at end of file diff --git a/asset/.repo-metadata.json b/asset/.repo-metadata.json new file mode 100644 index 000000000000..7ce6b3246473 --- /dev/null +++ b/asset/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "asset", + "name_pretty": "Cloud Asset Inventory", + "product_documentation": "https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview", + "client_documentation": "https://googleapis.dev/python/asset/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/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/bigquery/.repo-metadata.json b/bigquery/.repo-metadata.json new file mode 100644 index 000000000000..3f48aae44587 --- /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": "nodejs", + "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_datatransfer/.repo-metadata.json b/bigquery_datatransfer/.repo-metadata.json new file mode 100644 index 000000000000..182691ac35be --- /dev/null +++ b/bigquery_datatransfer/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "bigquery-datatransfer", + "name_pretty": "Google BigQuery Data Transfer Service", + "product_documentation": "https://cloud.google.com/bigquery/transfer/", + "client_documentation": "https://googleapis.dev/python/bigquery-datatransfer/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_storage/.repo-metadata.json b/bigquery_storage/.repo-metadata.json new file mode 100644 index 000000000000..67d6065568f9 --- /dev/null +++ b/bigquery_storage/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "bigquery-storage", + "name_pretty": "Google BigQuery Storage", + "product_documentation": "https://cloud.google.com/bigquery/docs/reference/storage/", + "client_documentation": "https://googleapis.dev/python/bigquery-storage/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": "bigquerydatatransfer.googleapis.com", + "requires_billing": true +} \ No newline at end of file diff --git a/bigtable/.repo-metadata.json b/bigtable/.repo-metadata.json new file mode 100644 index 000000000000..4c91d2e90dce --- /dev/null +++ b/bigtable/.repo-metadata.json @@ -0,0 +1,14 @@ + +{ + "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/container/.repo-metadata.json b/container/.repo-metadata.json new file mode 100644 index 000000000000..591b45549e05 --- /dev/null +++ b/container/.repo-metadata.json @@ -0,0 +1,14 @@ + +{ + "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/containeranalysis/.repo-metadata.json b/containeranalysis/.repo-metadata.json new file mode 100644 index 000000000000..3a614a05e0ad --- /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": "nodejs", + "repo": "googleapis/google-cloud-python", + "distribution_name": "google-cloud-containeranalysis", + "api_id": "containeranalysis.googleapis.com", + "requires_billing": false +} \ No newline at end of file diff --git a/datacatalog/.repo-metadata.json b/datacatalog/.repo-metadata.json new file mode 100644 index 000000000000..2b9c2306c1e8 --- /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://cloud.google.com/nodejs/docs/reference/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/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/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/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/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/dns/.repo-metadata.json b/dns/.repo-metadata.json new file mode 100644 index 000000000000..769a846af295 --- /dev/null +++ b/dns/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "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", + "api_id": "dns.googleapis.com", + "requires_billing": true +} \ No newline at end of file diff --git a/error_reporting/.repo-metadata.json b/error_reporting/.repo-metadata.json new file mode 100644 index 000000000000..f0d6c8bce01a --- /dev/null +++ b/error_reporting/.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": "ga", + "language": "python", + "repo": "googleapis/google-cloud-python", + "distribution_name": "google-cloud-firestore", + "api_id": "firestore.googleapis.com", + "requires_billing": false +} \ No newline at end of file diff --git a/firestore/.repo-metadata.json b/firestore/.repo-metadata.json new file mode 100644 index 000000000000..e69de29bb2d1 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/iam/.repo-metadata.json b/iam/.repo-metadata.json new file mode 100644 index 000000000000..bed3a0584d0c --- /dev/null +++ b/iam/.repo-metadata.json @@ -0,0 +1,12 @@ +{ + "name": "iam", + "name_pretty": "Cloud Identity and Access Management", + "product_documentation": "https://cloud.google.com/iam/docs/", + "client_documentation": "https://googleapis.dev/python/iam/latest", + "issue_tracker": "", + "release_level": "alpha", + "language": "python", + "repo": "googleapis/google-cloud-python", + "distribution_name": "google-cloud-iam", + "api_id": "iam.googleapis.com", +} \ No newline at end of file diff --git a/iot/.repo-metadata.json b/iot/.repo-metadata.json new file mode 100644 index 000000000000..ba991c706fb6 --- /dev/null +++ b/iot/.repo-metadata.json @@ -0,0 +1,12 @@ + { + "name": "iot", + "name_pretty": "Google Cloud Internet of Things (IoT) Core", + "product_documentation": "https://cloud.google.com/iot", + "client_documentation": "https://googleapis.dev/python/iot/latest", + "release_level": "alpha", + "language": "python", + "repo": "googleapis/google-cloud-python", + "distribution_name": "google-cloud-iot", + "api_id": "iot.googleapis.com", + "requires_billing": true +} \ No newline at end of file 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/kms/.repo-metadata.json b/kms/.repo-metadata.json new file mode 100644 index 000000000000..3050dd01aa51 --- /dev/null +++ b/kms/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "kms", + "name_pretty": "Google Cloud Key Management Service", + "product_documentation": "https://cloud.google.com/kms", + "client_documentation": "https://googleapis.dev/python/kms/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": "kms.googleapis.com", + "requires_billing": true +} \ No newline at end of file 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/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/monitoring/.repo-metadata.json b/monitoring/.repo-metadata.json new file mode 100644 index 000000000000..e69de29bb2d1 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/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/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/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/resource_manager/.repo-metadata.json b/resource_manager/.repo-metadata.json new file mode 100644 index 000000000000..1a2447ab961f --- /dev/null +++ b/resource_manager/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "resource-manager", + "name_pretty": "Google Cloud Resource Manager API", + "product_documentation": "https://cloud.google.com/resource-manager", + "client_documentation": "https://googleapis.dev/python/resource/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/runtimeconfig/.repo-metadata.json b/runtimeconfig/.repo-metadata.json new file mode 100644 index 000000000000..55556bae756c --- /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/runtime-config/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/scheduler/.repo-metadata.json b/scheduler/.repo-metadata.json new file mode 100644 index 000000000000..726a59a3c3b3 --- /dev/null +++ b/scheduler/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "scheduler", + "name_pretty": "Google Cloud Scheduler", + "product_documentation": "https://cloud.google.com/scheduler/docs", + "client_documentation": "https://googleapis.dev/python/scheduler/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/securitycenter/.repo-metadata.json b/securitycenter/.repo-metadata.json new file mode 100644 index 000000000000..592844567d91 --- /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/security-center/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/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/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/storage/.repo-metadata.json b/storage/.repo-metadata.json new file mode 100644 index 000000000000..1b1f3d75cd59 --- /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-api.googleapis.com", + "requires_billing": true +} \ No newline at end of file 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/tasks/.repo-metadata.json b/tasks/.repo-metadata.json new file mode 100644 index 000000000000..25c188e768d4 --- /dev/null +++ b/tasks/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "tasks", + "name_pretty": "Cloud Tasks", + "product_documentation": "https://cloud.google.com/tasks/docs/", + "client_documentation": "https://googleapis.dev/python/tasks/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": "tasks.googleapis.com", + "requires_billing": true +} \ No newline at end of file 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/trace/.repo-metadata.json b/trace/.repo-metadata.json new file mode 100644 index 000000000000..931c3b2747ba --- /dev/null +++ b/trace/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "trace", + "name_pretty": "Stackdriver Trace", + "product_documentation": "https://cloud.google.com/trace/docs", + "client_documentation": "https://googleapis.dev/python/trace/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/translate/.repo-metadata.json b/translate/.repo-metadata.json new file mode 100644 index 000000000000..bbe4002ccfd1 --- /dev/null +++ b/translate/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "translate", + "name_pretty": "Cloud Translation", + "product_documentation": "https://cloud.google.com/translate/docs/", + "client_documentation": "https://googleapis.dev/python/translate/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": "translate.googleapis.com", + "requires_billing": true +} \ No newline at end of file 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/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/webrisk/.repo-metadata.json b/webrisk/.repo-metadata.json new file mode 100644 index 000000000000..f0930cbd5d50 --- /dev/null +++ b/webrisk/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "webrisk", + "name_pretty": "Cloud Video Intelligence", + "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/websecurityscanner/.repo-metadata.json b/websecurityscanner/.repo-metadata.json new file mode 100644 index 000000000000..120972b7ce76 --- /dev/null +++ b/websecurityscanner/.repo-metadata.json @@ -0,0 +1,13 @@ +{ + "name": "websecurityscanner", + "name_pretty": "Cloud Video Intelligence", + "product_documentation": "https://cloud.google.com/security-scannerdocs/", + "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 From 4f4177c91adc539c4830dffe64ea5ec71a2a3e41 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Thu, 20 Jun 2019 17:36:30 -0700 Subject: [PATCH 03/13] Add api_core and core --- api_core/.repo-metadata.json | 9 +++++++++ core/.repo-metadata.json | 9 +++++++++ 2 files changed, 18 insertions(+) create mode 100644 api_core/.repo-metadata.json create mode 100644 core/.repo-metadata.json diff --git a/api_core/.repo-metadata.json b/api_core/.repo-metadata.json new file mode 100644 index 000000000000..f20790a27050 --- /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/core/.repo-metadata.json b/core/.repo-metadata.json new file mode 100644 index 000000000000..201b29f3e328 --- /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 From 57eff5b1f0138453c533abf9136c87ff450223a4 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Thu, 20 Jun 2019 17:41:47 -0700 Subject: [PATCH 04/13] Change publish-docs to use repo metadata. --- .kokoro/publish-docs.sh | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index a28a544c5130..7aad03a08905 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -19,15 +19,17 @@ python3.6 -m nox --version # build docs nox -s docs -cd docs/_build/html - python3 -m pip install gcp-docuploader # create metadata python3 -m docuploader create-metadata \ ---name ${NAME} \ ---version ${VERSION} \ ---language python + --name=$(cat .repo-metadata.json | json name) \ + --version=$(cat package.json | json version) \ + --language=$(cat .repo-metadata.json | json language) \ + --distribution-name=$(cat .repo-metadata.json | json distribution_name) \ + --product-page=$(cat .repo-metadata.json | json product_documentation) \ + --github-repository=$(cat .repo-metadata.json | json repo) \ + --issue-tracker=$(cat .repo-metadata.json | json issue_tracker) # upload docs -python3 -m docuploader upload . --staging-bucket docs-staging \ No newline at end of file +python3 -m docuploader upload docs/_build/html --staging-bucket test-docs-staging \ No newline at end of file From 24f694e3cec27e81e334c391f073b96be3db0d67 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Thu, 20 Jun 2019 17:53:37 -0700 Subject: [PATCH 05/13] Add json parser. --- .kokoro/publish-docs.sh | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index 7aad03a08905..b7e6edb3f4eb 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -21,10 +21,13 @@ nox -s docs python3 -m pip install gcp-docuploader +# install json parser +npm i json@9.0.6 -g + # create metadata python3 -m docuploader create-metadata \ --name=$(cat .repo-metadata.json | json name) \ - --version=$(cat package.json | json version) \ + --version=$VERSION --language=$(cat .repo-metadata.json | json language) \ --distribution-name=$(cat .repo-metadata.json | json distribution_name) \ --product-page=$(cat .repo-metadata.json | json product_documentation) \ From 1726ef2728d88ee445d5e01760166c03ad159ac3 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Fri, 21 Jun 2019 09:48:22 -0700 Subject: [PATCH 06/13] Update .repo-metadata.json --- .kokoro/docs/iot.cfg | 5 - .kokoro/publish-docs.sh | 27 +- api_core/docs/auth.rst | 301 +++++++++++++++++++++++ api_core/docs/changelog.md | 1 + api_core/docs/client_info.rst | 11 + api_core/docs/conf.py | 366 ++++++++++++++++++++++++++++ api_core/docs/exceptions.rst | 6 + api_core/docs/helpers.rst | 26 ++ api_core/docs/iam.rst | 7 + api_core/docs/index.rst | 28 +++ api_core/docs/operation.rst | 6 + api_core/docs/operations_client.rst | 6 + api_core/docs/page_iterator.rst | 6 + api_core/docs/path_template.rst | 6 + api_core/docs/retry.rst | 6 + api_core/docs/timeout.rst | 6 + api_core/noxfile.py | 24 ++ core/docs/changelog.md | 1 + core/docs/client.rst | 6 + core/docs/conf.py | 366 ++++++++++++++++++++++++++++ core/docs/config.rst | 68 ++++++ core/docs/index.rst | 20 ++ core/noxfile.py | 23 ++ docs/core/auth.rst | 302 +---------------------- docs/core/client.rst | 7 +- docs/core/client_info.rst | 12 +- docs/core/exceptions.rst | 7 +- docs/core/helpers.rst | 27 +- docs/core/iam.rst | 8 +- docs/core/operation.rst | 7 +- docs/core/operations_client.rst | 7 +- docs/core/page_iterator.rst | 7 +- docs/core/path_template.rst | 7 +- docs/core/retry.rst | 7 +- docs/core/timeout.rst | 7 +- iot/.repo-metadata.json | 3 +- 36 files changed, 1319 insertions(+), 411 deletions(-) create mode 100644 api_core/docs/auth.rst create mode 120000 api_core/docs/changelog.md create mode 100644 api_core/docs/client_info.rst create mode 100644 api_core/docs/conf.py create mode 100644 api_core/docs/exceptions.rst create mode 100644 api_core/docs/helpers.rst create mode 100644 api_core/docs/iam.rst create mode 100644 api_core/docs/index.rst create mode 100644 api_core/docs/operation.rst create mode 100644 api_core/docs/operations_client.rst create mode 100644 api_core/docs/page_iterator.rst create mode 100644 api_core/docs/path_template.rst create mode 100644 api_core/docs/retry.rst create mode 100644 api_core/docs/timeout.rst create mode 120000 core/docs/changelog.md create mode 100644 core/docs/client.rst create mode 100644 core/docs/conf.py create mode 100644 core/docs/config.rst create mode 100644 core/docs/index.rst mode change 100644 => 120000 docs/core/auth.rst mode change 100644 => 120000 docs/core/client.rst mode change 100644 => 120000 docs/core/client_info.rst mode change 100644 => 120000 docs/core/exceptions.rst mode change 100644 => 120000 docs/core/helpers.rst mode change 100644 => 120000 docs/core/iam.rst mode change 100644 => 120000 docs/core/operation.rst mode change 100644 => 120000 docs/core/operations_client.rst mode change 100644 => 120000 docs/core/page_iterator.rst mode change 100644 => 120000 docs/core/path_template.rst mode change 100644 => 120000 docs/core/retry.rst mode change 100644 => 120000 docs/core/timeout.rst diff --git a/.kokoro/docs/iot.cfg b/.kokoro/docs/iot.cfg index 6d6e5b533531..114c8da20d77 100644 --- a/.kokoro/docs/iot.cfg +++ b/.kokoro/docs/iot.cfg @@ -4,9 +4,4 @@ env_vars: { key: "PACKAGE" value: "iot" -} - -env_vars: { - key: "NAME" - value: "iot" } \ No newline at end of file diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index b7e6edb3f4eb..d743466aed11 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -7,8 +7,6 @@ export PYTHONUNBUFFERED=1 cd github/google-cloud-python/${PACKAGE} -VERSION=$(python3 setup.py --version) - # Remove old nox python3.6 -m pip uninstall --yes --quiet nox-automation @@ -21,18 +19,23 @@ nox -s docs python3 -m pip install gcp-docuploader -# install json parser -npm i json@9.0.6 -g +# install a json parser +sudo apt-get update +sudo apt-get -y install software-properties-common +sudo add-apt-repository universe +sudo apt-get -y install jq # create metadata python3 -m docuploader create-metadata \ - --name=$(cat .repo-metadata.json | json name) \ - --version=$VERSION - --language=$(cat .repo-metadata.json | json language) \ - --distribution-name=$(cat .repo-metadata.json | json distribution_name) \ - --product-page=$(cat .repo-metadata.json | json product_documentation) \ - --github-repository=$(cat .repo-metadata.json | json repo) \ - --issue-tracker=$(cat .repo-metadata.json | json issue_tracker) + --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=$(jq --raw-output '.distribution_name // empty' .repo-metadata.json) \ + --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 --staging-bucket test-docs-staging \ No newline at end of file +python3 -m docuploader upload docs/_build/html --metadata-file docs.metadata --staging-bucket docs-staging \ No newline at end of file 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 ` +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 `: + +.. 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 ` +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 ` +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() ` +factory can be used to create a :class:`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 ` +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 ` +can be serialized with +:meth:`to_json() ` +and stored in a file and then and deserialized with +:meth:`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 + + + + .. 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 + + + + .. raw:: html + + + + 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 + + + +.. _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/conf.py b/api_core/docs/conf.py new file mode 100644 index 000000000000..f1f3a2c1904a --- /dev/null +++ b/api_core/docs/conf.py @@ -0,0 +1,366 @@ +# -*- 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 +# " v 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 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.github.io/google-cloud-python/latest", + None, + ), + "grpc": ("https://grpc.io/grpc/python/", None), + "requests": ("http://docs.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/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..112bb30f2054 --- /dev/null +++ b/api_core/docs/index.rst @@ -0,0 +1,28 @@ +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 + exceptions + 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/noxfile.py b/api_core/noxfile.py index 06e78c1d1472..5e70db20dcd1 100644 --- a/api_core/noxfile.py +++ b/api_core/noxfile.py @@ -14,6 +14,7 @@ from __future__ import absolute_import import os +import shutil # https://github.com/google/importlab/issues/25 import nox # pytype: disable=import-error @@ -103,3 +104,26 @@ def cover(session): 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/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..348f2b36a033 --- /dev/null +++ b/core/docs/conf.py @@ -0,0 +1,366 @@ +# -*- 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 +# " v 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 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.github.io/google-cloud-python/latest", + None, + ), + "grpc": ("https://grpc.io/grpc/python/", None), + "requests": ("http://docs.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..de1a2eb8de79 --- /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 `_. + +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/noxfile.py b/core/noxfile.py index 55c0fe2132e3..5ac660e4c410 100644 --- a/core/noxfile.py +++ b/core/noxfile.py @@ -14,6 +14,7 @@ from __future__ import absolute_import import os +import shutil import nox @@ -86,3 +87,25 @@ def cover(session): 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/docs/core/auth.rst b/docs/core/auth.rst deleted file mode 100644 index f309a3a018ec..000000000000 --- a/docs/core/auth.rst +++ /dev/null @@ -1,301 +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 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 ` -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 `: - -.. 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 ` -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 ` -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() ` -factory can be used to create a :class:`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 ` -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 ` -can be serialized with -:meth:`to_json() ` -and stored in a file and then and deserialized with -:meth:`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 - - - - .. 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 - - - - .. raw:: html - - - - 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 - - - -.. _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/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 deleted file mode 100644 index 3d16e2aa9f54..000000000000 --- a/docs/core/client.rst +++ /dev/null @@ -1,6 +0,0 @@ -Base Client -=========== - -.. automodule:: google.cloud.client - :members: - :show-inheritance: 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 deleted file mode 100644 index e976b1863c7c..000000000000 --- a/docs/core/client_info.rst +++ /dev/null @@ -1,11 +0,0 @@ -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/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/exceptions.rst b/docs/core/exceptions.rst deleted file mode 100644 index d671f4e02046..000000000000 --- a/docs/core/exceptions.rst +++ /dev/null @@ -1,6 +0,0 @@ -Exceptions -========== - -.. automodule:: google.api_core.exceptions - :members: - :show-inheritance: 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 deleted file mode 100644 index 6f72df9561ef..000000000000 --- a/docs/core/helpers.rst +++ /dev/null @@ -1,26 +0,0 @@ -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/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 deleted file mode 100644 index bb80ae3c5798..000000000000 --- a/docs/core/iam.rst +++ /dev/null @@ -1,7 +0,0 @@ -Identity and Access Management -============================== - -.. automodule:: google.api_core.iam - :members: - :show-inheritance: - :member-order: bysource 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/operation.rst b/docs/core/operation.rst deleted file mode 100644 index c5e676621318..000000000000 --- a/docs/core/operation.rst +++ /dev/null @@ -1,6 +0,0 @@ -Long-Running Operations -======================= - -.. automodule:: google.api_core.operation - :members: - :show-inheritance: 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 deleted file mode 100644 index be466d3fbf43..000000000000 --- a/docs/core/operations_client.rst +++ /dev/null @@ -1,6 +0,0 @@ -Long-Running Operations Client -============================== - -.. automodule:: google.api_core.operations_v1 - :members: - :show-inheritance: 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 deleted file mode 100644 index 28842da2a76d..000000000000 --- a/docs/core/page_iterator.rst +++ /dev/null @@ -1,6 +0,0 @@ -Page Iterators -============== - -.. automodule:: google.api_core.page_iterator - :members: - :show-inheritance: 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 deleted file mode 100644 index 220779e3ba9f..000000000000 --- a/docs/core/path_template.rst +++ /dev/null @@ -1,6 +0,0 @@ -Path Templates -============== - -.. automodule:: google.api_core.path_template - :members: - :show-inheritance: 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 deleted file mode 100644 index 23a7d70f3431..000000000000 --- a/docs/core/retry.rst +++ /dev/null @@ -1,6 +0,0 @@ -Retry -===== - -.. automodule:: google.api_core.retry - :members: - :show-inheritance: 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 deleted file mode 100644 index 943d42508997..000000000000 --- a/docs/core/timeout.rst +++ /dev/null @@ -1,6 +0,0 @@ -Timeout -======= - -.. automodule:: google.api_core.timeout - :members: - :show-inheritance: 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/iot/.repo-metadata.json b/iot/.repo-metadata.json index ba991c706fb6..003ba879447c 100644 --- a/iot/.repo-metadata.json +++ b/iot/.repo-metadata.json @@ -1,8 +1,9 @@ - { +{ "name": "iot", "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", From b33d12cb7c5361b46e54d1a8c784467cd0963f44 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Fri, 21 Jun 2019 16:07:46 -0700 Subject: [PATCH 07/13] Fix repo metadata. --- bigquery/.repo-metadata.json | 2 +- bigtable/.repo-metadata.json | 1 - container/.repo-metadata.json | 1 - error_reporting/.repo-metadata.json | 16 ++++++++-------- firestore/.repo-metadata.json | 13 +++++++++++++ iam/.repo-metadata.json | 2 +- monitoring/.repo-metadata.json | 12 ++++++++++++ resource_manager/.repo-metadata.json | 4 ++-- runtimeconfig/.repo-metadata.json | 2 +- securitycenter/.repo-metadata.json | 2 +- webrisk/.repo-metadata.json | 2 +- websecurityscanner/.repo-metadata.json | 4 ++-- 12 files changed, 42 insertions(+), 19 deletions(-) diff --git a/bigquery/.repo-metadata.json b/bigquery/.repo-metadata.json index 3f48aae44587..3c1baf6edd57 100644 --- a/bigquery/.repo-metadata.json +++ b/bigquery/.repo-metadata.json @@ -5,7 +5,7 @@ "client_documentation": "https://googleapis.dev/python/bigquery/latest", "issue_tracker": "https://issuetracker.google.com/savedsearches/559654", "release_level": "ga", - "language": "nodejs", + "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-bigquery", "api_id": "bigquery.googleapis.com", diff --git a/bigtable/.repo-metadata.json b/bigtable/.repo-metadata.json index 4c91d2e90dce..956c74b53395 100644 --- a/bigtable/.repo-metadata.json +++ b/bigtable/.repo-metadata.json @@ -1,4 +1,3 @@ - { "name": "bigtable", "name_pretty": "Cloud Bigtable", diff --git a/container/.repo-metadata.json b/container/.repo-metadata.json index 591b45549e05..9eff44e5832e 100644 --- a/container/.repo-metadata.json +++ b/container/.repo-metadata.json @@ -1,4 +1,3 @@ - { "name": "container", "name_pretty": "Kubernetes Engine", diff --git a/error_reporting/.repo-metadata.json b/error_reporting/.repo-metadata.json index f0d6c8bce01a..9bbc93ae5596 100644 --- a/error_reporting/.repo-metadata.json +++ b/error_reporting/.repo-metadata.json @@ -1,13 +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": "ga", + "name": "clouderroreporting", + "name_pretty": "Stackdriver Error Reporting", + "product_documentation": "https://cloud.google.com/error-reporting", + "client_documentation": "https://googleapis.dev/python/clouderroreporting/latest", + "issue_tracker": "https://issuetracker.google.com/savedsearches/559780", + "release_level": "alpha", "language": "python", "repo": "googleapis/google-cloud-python", - "distribution_name": "google-cloud-firestore", - "api_id": "firestore.googleapis.com", + "distribution_name": "google-cloud-error-reporting", + "api_id": "clouderroreporting.googleapis.com", "requires_billing": false } \ No newline at end of file diff --git a/firestore/.repo-metadata.json b/firestore/.repo-metadata.json index e69de29bb2d1..6a3e669fce83 100644 --- a/firestore/.repo-metadata.json +++ 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/iam/.repo-metadata.json b/iam/.repo-metadata.json index bed3a0584d0c..d85ca35b56b3 100644 --- a/iam/.repo-metadata.json +++ b/iam/.repo-metadata.json @@ -3,7 +3,7 @@ "name_pretty": "Cloud Identity and Access Management", "product_documentation": "https://cloud.google.com/iam/docs/", "client_documentation": "https://googleapis.dev/python/iam/latest", - "issue_tracker": "", + "issue_tracker": "https://issuetracker.google.com/savedsearches/559761", "release_level": "alpha", "language": "python", "repo": "googleapis/google-cloud-python", diff --git a/monitoring/.repo-metadata.json b/monitoring/.repo-metadata.json index e69de29bb2d1..48920988588f 100644 --- a/monitoring/.repo-metadata.json +++ 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/resource_manager/.repo-metadata.json b/resource_manager/.repo-metadata.json index 1a2447ab961f..6986af7d7a09 100644 --- a/resource_manager/.repo-metadata.json +++ b/resource_manager/.repo-metadata.json @@ -1,8 +1,8 @@ { - "name": "resource-manager", + "name": "cloudresourcemanager", "name_pretty": "Google Cloud Resource Manager API", "product_documentation": "https://cloud.google.com/resource-manager", - "client_documentation": "https://googleapis.dev/python/resource/latest", + "client_documentation": "https://googleapis.dev/python/cloudresourcemanager/latest", "issue_tracker": "https://issuetracker.google.com/savedsearches/559757", "release_level": "alpha", "language": "python", diff --git a/runtimeconfig/.repo-metadata.json b/runtimeconfig/.repo-metadata.json index 55556bae756c..7801655872cf 100644 --- a/runtimeconfig/.repo-metadata.json +++ b/runtimeconfig/.repo-metadata.json @@ -2,7 +2,7 @@ "name": "runtimeconfig", "name_pretty": "Google Cloud Runtime Configurator", "product_documentation": "https://cloud.google.com/deployment-manager/runtime-configurator/", - "client_documentation": "https://googleapis.dev/python/runtime-config/latest", + "client_documentation": "https://googleapis.dev/python/runtimeconfig/latest", "issue_tracker": "https://issuetracker.google.com/savedsearches/559663", "release_level": "alpha", "language": "python", diff --git a/securitycenter/.repo-metadata.json b/securitycenter/.repo-metadata.json index 592844567d91..4f88503d7db9 100644 --- a/securitycenter/.repo-metadata.json +++ b/securitycenter/.repo-metadata.json @@ -2,7 +2,7 @@ "name": "securitycenter", "name_pretty": "Google Cloud Security Command Center", "product_documentation": "https://cloud.google.com/security-command-center", - "client_documentation": "https://googleapis.dev/python/security-center/latest", + "client_documentation": "https://googleapis.dev/python/securitycenter/latest", "issue_tracker": "https://issuetracker.google.com/savedsearches/559748", "release_level": "alpha", "language": "python", diff --git a/webrisk/.repo-metadata.json b/webrisk/.repo-metadata.json index f0930cbd5d50..f240f01bfb68 100644 --- a/webrisk/.repo-metadata.json +++ b/webrisk/.repo-metadata.json @@ -1,6 +1,6 @@ { "name": "webrisk", - "name_pretty": "Cloud Video Intelligence", + "name_pretty": "Web Risk", "product_documentation": "https://cloud.google.com/web-risk/docs/", "client_documentation": "https://googleapis.dev/python/webrisk/latest", "issue_tracker": "", diff --git a/websecurityscanner/.repo-metadata.json b/websecurityscanner/.repo-metadata.json index 120972b7ce76..faf8a58cda54 100644 --- a/websecurityscanner/.repo-metadata.json +++ b/websecurityscanner/.repo-metadata.json @@ -1,7 +1,7 @@ { "name": "websecurityscanner", - "name_pretty": "Cloud Video Intelligence", - "product_documentation": "https://cloud.google.com/security-scannerdocs/", + "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", From f04b1c3d90df225d6c27aeda518854e6f558bfeb Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Fri, 21 Jun 2019 16:26:15 -0700 Subject: [PATCH 08/13] Remove trailing comma in repo-metadata. --- api_core/.repo-metadata.json | 2 +- core/.repo-metadata.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api_core/.repo-metadata.json b/api_core/.repo-metadata.json index f20790a27050..6a5f3f53359f 100644 --- a/api_core/.repo-metadata.json +++ b/api_core/.repo-metadata.json @@ -5,5 +5,5 @@ "release_level": "ga", "language": "python", "repo": "googleapis/google-cloud-python", - "distribution_name": "google-api-core", + "distribution_name": "google-api-core" } \ No newline at end of file diff --git a/core/.repo-metadata.json b/core/.repo-metadata.json index 201b29f3e328..aa91b47586b6 100644 --- a/core/.repo-metadata.json +++ b/core/.repo-metadata.json @@ -5,5 +5,5 @@ "release_level": "ga", "language": "python", "repo": "googleapis/google-cloud-python", - "distribution_name": "google-cloud-core", + "distribution_name": "google-cloud-core" } \ No newline at end of file From 169cf82ee0eb7aedd84fd1e1356b3562de8b8608 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Mon, 24 Jun 2019 09:48:02 -0700 Subject: [PATCH 09/13] Fixes from code review. --- .kokoro/publish-docs.sh | 2 +- .repo-metadata.json | 13 ------------- bigquery/.repo-metadata.json | 2 +- 3 files changed, 2 insertions(+), 15 deletions(-) delete mode 100644 .repo-metadata.json diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index d743466aed11..5300e53391c0 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -20,9 +20,9 @@ nox -s docs python3 -m pip install gcp-docuploader # install a json parser +sudo add-apt-repository universe sudo apt-get update sudo apt-get -y install software-properties-common -sudo add-apt-repository universe sudo apt-get -y install jq # create metadata diff --git a/.repo-metadata.json b/.repo-metadata.json deleted file mode 100644 index 0e9078fe76f2..000000000000 --- a/.repo-metadata.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "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", - "requires_billing": true -} \ No newline at end of file diff --git a/bigquery/.repo-metadata.json b/bigquery/.repo-metadata.json index 3c1baf6edd57..5b4734b8e389 100644 --- a/bigquery/.repo-metadata.json +++ b/bigquery/.repo-metadata.json @@ -1,6 +1,6 @@ { "name": "bigquery", - "name_pretty": "Google Cloud 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", From fa7827c71bebdc8f577efdf072ba260d9eaa03db Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Mon, 24 Jun 2019 10:32:58 -0700 Subject: [PATCH 10/13] Undo change to publish-docs script. --- .kokoro/publish-docs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index 5300e53391c0..d743466aed11 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -20,9 +20,9 @@ nox -s docs python3 -m pip install gcp-docuploader # install a json parser -sudo add-apt-repository universe sudo apt-get update sudo apt-get -y install software-properties-common +sudo add-apt-repository universe sudo apt-get -y install jq # create metadata From 42a92231ee43912ceffd7130e491127b4ca68d33 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Mon, 24 Jun 2019 12:17:41 -0700 Subject: [PATCH 11/13] Get distribution name from setup.py --- .kokoro/publish-docs.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index d743466aed11..5e07edd68d01 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -30,7 +30,7 @@ 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=$(jq --raw-output '.distribution_name // 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) From f75953c9ba77745032de1bdc59ca963612630645 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Mon, 24 Jun 2019 14:44:05 -0700 Subject: [PATCH 12/13] Run apt-get update after add-apt-repository. --- .kokoro/publish-docs.sh | 1 + 1 file changed, 1 insertion(+) diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index 5e07edd68d01..d6762b5ed6f9 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -23,6 +23,7 @@ python3 -m pip install gcp-docuploader 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 From c03c3acaf357f5b281066f08670191e1c7b6187b Mon Sep 17 00:00:00 2001 From: Bu Sun Kim Date: Mon, 24 Jun 2019 16:57:45 -0700 Subject: [PATCH 13/13] Last fixes to 'name' and api_id --- asset/.repo-metadata.json | 2 +- bigquery_datatransfer/.repo-metadata.json | 2 +- bigquery_storage/.repo-metadata.json | 4 ++-- dns/.repo-metadata.json | 1 - iam/.repo-metadata.json | 2 +- iot/.repo-metadata.json | 4 ++-- kms/.repo-metadata.json | 4 ++-- scheduler/.repo-metadata.json | 2 +- storage/.repo-metadata.json | 2 +- tasks/.repo-metadata.json | 4 ++-- trace/.repo-metadata.json | 2 +- translate/.repo-metadata.json | 4 ++-- 12 files changed, 16 insertions(+), 17 deletions(-) diff --git a/asset/.repo-metadata.json b/asset/.repo-metadata.json index 7ce6b3246473..4b22497fffc5 100644 --- a/asset/.repo-metadata.json +++ b/asset/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "asset", + "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/asset/latest", diff --git a/bigquery_datatransfer/.repo-metadata.json b/bigquery_datatransfer/.repo-metadata.json index 182691ac35be..bed54e6688ec 100644 --- a/bigquery_datatransfer/.repo-metadata.json +++ b/bigquery_datatransfer/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "bigquery-datatransfer", + "name": "bigquerydatatransfer", "name_pretty": "Google BigQuery Data Transfer Service", "product_documentation": "https://cloud.google.com/bigquery/transfer/", "client_documentation": "https://googleapis.dev/python/bigquery-datatransfer/latest", diff --git a/bigquery_storage/.repo-metadata.json b/bigquery_storage/.repo-metadata.json index 67d6065568f9..3f1ecb00a785 100644 --- a/bigquery_storage/.repo-metadata.json +++ b/bigquery_storage/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "bigquery-storage", + "name": "bigquerystorage", "name_pretty": "Google BigQuery Storage", "product_documentation": "https://cloud.google.com/bigquery/docs/reference/storage/", "client_documentation": "https://googleapis.dev/python/bigquery-storage/latest", @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-bigquery-storage", - "api_id": "bigquerydatatransfer.googleapis.com", + "api_id": "bigquerystorage.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/dns/.repo-metadata.json b/dns/.repo-metadata.json index 769a846af295..835bbd8ffb2b 100644 --- a/dns/.repo-metadata.json +++ b/dns/.repo-metadata.json @@ -8,6 +8,5 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-dns", - "api_id": "dns.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/iam/.repo-metadata.json b/iam/.repo-metadata.json index d85ca35b56b3..d399af12a6b6 100644 --- a/iam/.repo-metadata.json +++ b/iam/.repo-metadata.json @@ -8,5 +8,5 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-iam", - "api_id": "iam.googleapis.com", + "api_id": "iamcredentials.googleapis.com", } \ No newline at end of file diff --git a/iot/.repo-metadata.json b/iot/.repo-metadata.json index 003ba879447c..0fd78d6b99d4 100644 --- a/iot/.repo-metadata.json +++ b/iot/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "iot", + "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", @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-iot", - "api_id": "iot.googleapis.com", + "api_id": "cloudiot.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/kms/.repo-metadata.json b/kms/.repo-metadata.json index 3050dd01aa51..71909f7ec97f 100644 --- a/kms/.repo-metadata.json +++ b/kms/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "kms", + "name": "cloudkms", "name_pretty": "Google Cloud Key Management Service", "product_documentation": "https://cloud.google.com/kms", "client_documentation": "https://googleapis.dev/python/kms/latest", @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-kms", - "api_id": "kms.googleapis.com", + "api_id": "cloudkms.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/scheduler/.repo-metadata.json b/scheduler/.repo-metadata.json index 726a59a3c3b3..74ef765e8ca8 100644 --- a/scheduler/.repo-metadata.json +++ b/scheduler/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "scheduler", + "name": "cloudscheduler", "name_pretty": "Google Cloud Scheduler", "product_documentation": "https://cloud.google.com/scheduler/docs", "client_documentation": "https://googleapis.dev/python/scheduler/latest", diff --git a/storage/.repo-metadata.json b/storage/.repo-metadata.json index 1b1f3d75cd59..0468fe0d51e7 100644 --- a/storage/.repo-metadata.json +++ b/storage/.repo-metadata.json @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-storage", - "api_id": "storage-api.googleapis.com", + "api_id": "storage.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/tasks/.repo-metadata.json b/tasks/.repo-metadata.json index 25c188e768d4..b56da1e4fb16 100644 --- a/tasks/.repo-metadata.json +++ b/tasks/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "tasks", + "name": "cloudtasks", "name_pretty": "Cloud Tasks", "product_documentation": "https://cloud.google.com/tasks/docs/", "client_documentation": "https://googleapis.dev/python/tasks/latest", @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-tasks", - "api_id": "tasks.googleapis.com", + "api_id": "cloudtasks.googleapis.com", "requires_billing": true } \ No newline at end of file diff --git a/trace/.repo-metadata.json b/trace/.repo-metadata.json index 931c3b2747ba..171998cf3aa0 100644 --- a/trace/.repo-metadata.json +++ b/trace/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "trace", + "name": "cloudtrace", "name_pretty": "Stackdriver Trace", "product_documentation": "https://cloud.google.com/trace/docs", "client_documentation": "https://googleapis.dev/python/trace/latest", diff --git a/translate/.repo-metadata.json b/translate/.repo-metadata.json index bbe4002ccfd1..3927d8d1fe03 100644 --- a/translate/.repo-metadata.json +++ b/translate/.repo-metadata.json @@ -1,5 +1,5 @@ { - "name": "translate", + "name": "translation", "name_pretty": "Cloud Translation", "product_documentation": "https://cloud.google.com/translate/docs/", "client_documentation": "https://googleapis.dev/python/translate/latest", @@ -8,6 +8,6 @@ "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-translate", - "api_id": "translate.googleapis.com", + "api_id": "translation.googleapis.com", "requires_billing": true } \ No newline at end of file