[jobs] testing: use multiple projects (GoogleCloudPlatform#3973)

Takashi Matsuo · leahecole · web-flow · commit 759db930f490 · 2020-06-08T13:33:14.000-07:00
* [jobs] testing: use multiple projects fixes GoogleCloudPlatform#3969 * Always wait 60 seconds before retrying Co-authored-by: Leah E. Cole <6719667+leahecole@users.noreply.github.com>
diff --git a/jobs/v3/api_client/README.rst b/jobs/v3/api_client/README.rst
@@ -4,16 +4,28 @@ Google Cloud Talent Solution API Python Samples
 ===============================================================================
 
 .. image:: https://gstatic.com/cloudssh/images/open-btn.png
-   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/cjd_sample/README.rst
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/README.rst
 
 
-This directory contains samples for Google Cloud Talent Solution API. 
-The `Google Talent Solution API` is part of Google for Jobs - a Google-wide commitment to help people find jobs more easily. Talent Solution provides plug and play access to Google’s search and machine learning capabilities, enabling the entire recruiting ecosystem - company career sites, job boards, applicant tracking systems, and staffing agencies to improve job site engagement and candidate conversion.
+This directory contains samples for Google Cloud Talent Solution API. `Cloud Talent Solution` is a service that brings machine learning to your job
+ search experience, returning high quality results to job seekers far beyond
+ the limitations of typical keyword-based methods. Once integrated with your
+ job content, Cloud Talent Solution automatically detects and infers various
+ kinds of data, such as related titles, seniority, and industry.
+
 
 
 
 .. _Google Cloud Talent Solution API: https://cloud.google.com/talent-solution/job-search/docs/
 
+To run the sample, you need to enable the API at: https://console.cloud.google.com/apis/library/jobs.googleapis.com
+
+To run the sample, you need to have `Talent Solution Job Editor` role.
+
+
+Visit [Data logging page](https://console.cloud.google.com/talent-solution/data-permission-onboard) and enable the Data logging on your cloud project and connect at least one service account.
+
+
 Setup
 -------------------------------------------------------------------------------
 
@@ -61,11 +73,29 @@ Install Dependencies
 Samples
 -------------------------------------------------------------------------------
 
-Quickstart
+AutoCompleteSample
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
 .. image:: https://gstatic.com/cloudssh/images/open-btn.png
-   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/cjd_sample/base_company_sample.py,jobs/cjd_sample/README.rst
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/auto_complete_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python auto_complete_sample.py
+
+
+BaseCompanySample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/base_company_sample.py,jobs/v2/api_client/README.rst
+
+
 
 
 To run this sample:
@@ -75,4 +105,150 @@ To run this sample:
     $ python base_company_sample.py
 
 
-.. _Google Cloud SDK: https://cloud.google.com/sdk/
+BaseJobSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/base_job_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python base_job_sample.py
+
+
+BatchOperationSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/batch_operation_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python batch_operation_sample.py
+
+
+CommuteSearchSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/commute_search_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python commute_search_sample.py
+
+
+CustomAttributeSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/custom_attribute_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python custom_attribute_sample.py
+
+
+EmailAlertSearchSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/email_alert_search_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python email_alert_search_sample.py
+
+
+FeaturedJobSearchSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/featured_job_search_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python featured_job_search_sample.py
+
+
+GeneraSearchSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/general_search_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python general_search_sample.py
+
+
+HistogramSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/histogram_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python histogram_sample.py
+
+
+LocationSearchSample
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=jobs/v2/api_client/location_search_sample.py,jobs/v2/api_client/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python location_search_sample.py
+
+
+
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/
diff --git a/jobs/v3/api_client/README.rst.in b/jobs/v3/api_client/README.rst.in
@@ -4,13 +4,19 @@ product:
   name: Google Cloud Talent Solution API
   short_name: CTS
   url: https://cloud.google.com/talent-solution/job-search/docs/
-  description: > 
+  description: >
     `Cloud Talent Solution` is a service that brings machine learning to your job
-     search experience, returning high quality results to job seekers far beyond 
-     the limitations of typical keyword-based methods. Once integrated with your 
-     job content, Cloud Talent Solution automatically detects and infers various 
+     search experience, returning high quality results to job seekers far beyond
+     the limitations of typical keyword-based methods. Once integrated with your
+     job content, Cloud Talent Solution automatically detects and infers various
      kinds of data, such as related titles, seniority, and industry.
 
+required_api_url: https://console.cloud.google.com/apis/library/jobs.googleapis.com
+required_role: Talent Solution Job Editor
+other_required_steps: >
+    Visit [Data logging page](https://console.cloud.google.com/talent-solution/data-permission-onboard) and enable the Data logging on your cloud project and connect at least one service account.
+
+
 setup:
 - auth
 - install_deps
diff --git a/jobs/v3/api_client/email_alert_search_sample_test.py b/jobs/v3/api_client/email_alert_search_sample_test.py
@@ -26,8 +26,14 @@ def company_name():
     email_alert_search_sample.tear_down(company_name, job_name)
 
 
+def retry_delay():
+    # Always wait 60 seconds
+    yield 60
+
+
 def test_email_alert_search_sample(company_name, capsys):
-    @backoff.on_exception(backoff.expo, AssertionError, max_time=120)
+
+    @backoff.on_exception(retry_delay, AssertionError, max_time=240)
     def eventually_consistent_test():
         email_alert_search_sample.run_sample(company_name)
         out, _ = capsys.readouterr()
diff --git a/jobs/v3/api_client/noxfile_config.py b/jobs/v3/api_client/noxfile_config.py
@@ -0,0 +1,37 @@
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Default TEST_CONFIG_OVERRIDE for python repos.
+
+# You can copy this file into your directory, then it will be inported from
+# the noxfile.py.
+
+# The source of truth:
+# https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/noxfile_config.py
+
+TEST_CONFIG_OVERRIDE = {
+    # You can opt out from the test for specific Python versions.
+    'ignored_versions': ["2.7"],
+
+    # An envvar key for determining the project id to use. Change it
+    # to 'BUILD_SPECIFIC_GCLOUD_PROJECT' if you want to opt in using a
+    # build specific Cloud project. You can also use your own string
+    # to use your own Cloud project.
+    # 'gcloud_project_env': 'GCLOUD_PROJECT',
+    'gcloud_project_env': 'BUILD_SPECIFIC_GCLOUD_PROJECT',
+
+    # A dictionary you want to inject into your test. Don't put any
+    # secrets here. These values will override predefined values.
+    'envs': {},
+}
