feat: add v4

UPGRADING.md

@@ -37,7 +37,7 @@ response = client.batch_create_jobs(parent, jobs)
 
 **After:**
 ```py
-response = client.batch_create_jobs(request={"parent": "''", "jobs": "[]"})
+response = client.batch_create_jobs(request={"parent": "parent", "jobs": []})
 ```
 
 ### More Details
@@ -103,4 +103,56 @@ response = client.batch_create_jobs(
     },
     jobs=jobs
 )
+```
+
+## v4beta1 -> v4
+
+In addition, this release adds the v4 API surface, which has breaking changes from the v4beta1.
+The `google.cloud.talent` import now resolves to `google.cloud.talent_v4`. To continue
+to use the `v4beta1`, import from it explicitly.
+
+The `v4` surface merges functionalty in the  `v3p1beta1` and `v4beta1`.
+
+```py
+from google.cloud import talent_v4beta1
+```
+
+
+### search_jobs
+
+`search_jobs` returns `SearchJobsResponse`. Matching jobs are in `SearchJobsResponse.matching_jobs`.
+
+
+**v4beta1:**
+```py
+from google.cloud import talent_v4beta1
+
+
+client = talent_v4beta1.JobServiceClient()
+
+#...
+request = talent_v4beta1.SearchJobsRequest(
+    parent=parent,
+    request_metadata=request_metadata,
+    job_query=job_query,
+)
+for response_item in client.search_jobs(request=request):
+    # ...
+```
+
+**v4**
+```py
+from google.cloud import talent_v4
+
+
+client = talent_v4.JobServiceClient()
+
+#...
+request = talent_v4.SearchJobsRequest(
+    parent=parent,
+    request_metadata=request_metadata,
+    job_query=job_query,
+)
+for response_item in client.search_jobs(request=request).matching_jobs:
+    # ...
 ```

docs/index.rst

@@ -2,19 +2,20 @@
 
 .. include:: multiprocessing.rst
 
-Api Reference
+API Reference
 -------------
 .. toctree::
     :maxdepth: 2
 
+    talent_v4/services
+    talent_v4/types
     talent_v4beta1/services
     talent_v4beta1/types
-    changelog
 
 Migration Guide
 ---------------
 
-See the guide below for instructions on migrating to the 2.x release of this library.
+See the guide below for instructions on migrating to the 1.x release of this library.
 
 .. toctree::
     :maxdepth: 2

docs/talent_v4/services.rst

@@ -0,0 +1,18 @@
+Services for Google Cloud Talent v4 API
+=======================================
+
+.. automodule:: google.cloud.talent_v4.services.company_service
+    :members:
+    :inherited-members:
+.. automodule:: google.cloud.talent_v4.services.completion
+    :members:
+    :inherited-members:
+.. automodule:: google.cloud.talent_v4.services.event_service
+    :members:
+    :inherited-members:
+.. automodule:: google.cloud.talent_v4.services.job_service
+    :members:
+    :inherited-members:
+.. automodule:: google.cloud.talent_v4.services.tenant_service
+    :members:
+    :inherited-members:

docs/talent_v4/types.rst

@@ -0,0 +1,5 @@
+Types for Google Cloud Talent v4 API
+====================================
+
+.. automodule:: google.cloud.talent_v4.types
+    :members:

google/cloud/talent_v4/__init__.py

@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from .services.company_service import CompanyServiceClient
+from .services.completion import CompletionClient
+from .services.event_service import EventServiceClient
+from .services.job_service import JobServiceClient
+from .services.tenant_service import TenantServiceClient
+from .types.common import BatchOperationMetadata
+from .types.common import CommuteMethod
+from .types.common import CompanySize
+from .types.common import CompensationInfo
+from .types.common import CustomAttribute
+from .types.common import DegreeType
+from .types.common import DeviceInfo
+from .types.common import EmploymentType
+from .types.common import HtmlSanitization
+from .types.common import JobBenefit
+from .types.common import JobCategory
+from .types.common import JobLevel
+from .types.common import Location
+from .types.common import PostingRegion
+from .types.common import RequestMetadata
+from .types.common import ResponseMetadata
+from .types.common import SpellingCorrection
+from .types.common import TimestampRange
+from .types.common import Visibility
+from .types.company import Company
+from .types.company_service import CreateCompanyRequest
+from .types.company_service import DeleteCompanyRequest
+from .types.company_service import GetCompanyRequest
+from .types.company_service import ListCompaniesRequest
+from .types.company_service import ListCompaniesResponse
+from .types.company_service import UpdateCompanyRequest
+from .types.completion_service import CompleteQueryRequest
+from .types.completion_service import CompleteQueryResponse
+from .types.event import ClientEvent
+from .types.event import JobEvent
+from .types.event_service import CreateClientEventRequest
+from .types.filters import CommuteFilter
+from .types.filters import CompensationFilter
+from .types.filters import JobQuery
+from .types.filters import LocationFilter
+from .types.histogram import HistogramQuery
+from .types.histogram import HistogramQueryResult
+from .types.job import Job
+from .types.job_service import BatchCreateJobsRequest
+from .types.job_service import BatchCreateJobsResponse
+from .types.job_service import BatchDeleteJobsRequest
+from .types.job_service import BatchDeleteJobsResponse
+from .types.job_service import BatchUpdateJobsRequest
+from .types.job_service import BatchUpdateJobsResponse
+from .types.job_service import CreateJobRequest
+from .types.job_service import DeleteJobRequest
+from .types.job_service import GetJobRequest
+from .types.job_service import JobResult
+from .types.job_service import JobView
+from .types.job_service import ListJobsRequest
+from .types.job_service import ListJobsResponse
+from .types.job_service import SearchJobsRequest
+from .types.job_service import SearchJobsResponse
+from .types.job_service import UpdateJobRequest
+from .types.tenant import Tenant
+from .types.tenant_service import CreateTenantRequest
+from .types.tenant_service import DeleteTenantRequest
+from .types.tenant_service import GetTenantRequest
+from .types.tenant_service import ListTenantsRequest
+from .types.tenant_service import ListTenantsResponse
+from .types.tenant_service import UpdateTenantRequest
+
+
+__all__ = (
+    "BatchCreateJobsRequest",
+    "BatchCreateJobsResponse",
+    "BatchDeleteJobsRequest",
+    "BatchDeleteJobsResponse",
+    "BatchOperationMetadata",
+    "BatchUpdateJobsRequest",
+    "BatchUpdateJobsResponse",
+    "ClientEvent",
+    "CommuteFilter",
+    "CommuteMethod",
+    "Company",
+    "CompanyServiceClient",
+    "CompanySize",
+    "CompensationFilter",
+    "CompensationInfo",
+    "CompleteQueryRequest",
+    "CompleteQueryResponse",
+    "CompletionClient",
+    "CreateClientEventRequest",
+    "CreateCompanyRequest",
+    "CreateJobRequest",
+    "CreateTenantRequest",
+    "CustomAttribute",
+    "DegreeType",
+    "DeleteCompanyRequest",
+    "DeleteJobRequest",
+    "DeleteTenantRequest",
+    "DeviceInfo",
+    "EmploymentType",
+    "EventServiceClient",
+    "GetCompanyRequest",
+    "GetJobRequest",
+    "GetTenantRequest",
+    "HistogramQuery",
+    "HistogramQueryResult",
+    "HtmlSanitization",
+    "Job",
+    "JobBenefit",
+    "JobCategory",
+    "JobEvent",
+    "JobLevel",
+    "JobQuery",
+    "JobResult",
+    "JobServiceClient",
+    "JobView",
+    "ListCompaniesRequest",
+    "ListCompaniesResponse",
+    "ListJobsRequest",
+    "ListJobsResponse",
+    "ListTenantsRequest",
+    "ListTenantsResponse",
+    "Location",
+    "LocationFilter",
+    "PostingRegion",
+    "RequestMetadata",
+    "ResponseMetadata",
+    "SearchJobsRequest",
+    "SearchJobsResponse",
+    "SpellingCorrection",
+    "Tenant",
+    "TimestampRange",
+    "UpdateCompanyRequest",
+    "UpdateJobRequest",
+    "UpdateTenantRequest",
+    "Visibility",
+    "TenantServiceClient",
+)