Skip to content
This repository was archived by the owner on Sep 5, 2023. It is now read-only.

Commit 80bef1f

Browse files
authored
feat: add v4 (#29)
1 parent ef045e8 commit 80bef1f

File tree

132 files changed

+31099
-2636
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

132 files changed

+31099
-2636
lines changed

UPGRADING.md

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ response = client.batch_create_jobs(parent, jobs)
3737

3838
**After:**
3939
```py
40-
response = client.batch_create_jobs(request={"parent": "''", "jobs": "[]"})
40+
response = client.batch_create_jobs(request={"parent": "parent", "jobs": []})
4141
```
4242

4343
### More Details
@@ -103,4 +103,56 @@ response = client.batch_create_jobs(
103103
},
104104
jobs=jobs
105105
)
106+
```
107+
108+
## v4beta1 -> v4
109+
110+
In addition, this release adds the v4 API surface, which has breaking changes from the v4beta1.
111+
The `google.cloud.talent` import now resolves to `google.cloud.talent_v4`. To continue
112+
to use the `v4beta1`, import from it explicitly.
113+
114+
The `v4` surface merges functionalty in the `v3p1beta1` and `v4beta1`.
115+
116+
```py
117+
from google.cloud import talent_v4beta1
118+
```
119+
120+
121+
### search_jobs
122+
123+
`search_jobs` returns `SearchJobsResponse`. Matching jobs are in `SearchJobsResponse.matching_jobs`.
124+
125+
126+
**v4beta1:**
127+
```py
128+
from google.cloud import talent_v4beta1
129+
130+
131+
client = talent_v4beta1.JobServiceClient()
132+
133+
#...
134+
request = talent_v4beta1.SearchJobsRequest(
135+
parent=parent,
136+
request_metadata=request_metadata,
137+
job_query=job_query,
138+
)
139+
for response_item in client.search_jobs(request=request):
140+
# ...
141+
```
142+
143+
**v4**
144+
```py
145+
from google.cloud import talent_v4
146+
147+
148+
client = talent_v4.JobServiceClient()
149+
150+
#...
151+
request = talent_v4.SearchJobsRequest(
152+
parent=parent,
153+
request_metadata=request_metadata,
154+
job_query=job_query,
155+
)
156+
for response_item in client.search_jobs(request=request).matching_jobs:
157+
# ...
106158
```

docs/index.rst

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,20 @@
22

33
.. include:: multiprocessing.rst
44

5-
Api Reference
5+
API Reference
66
-------------
77
.. toctree::
88
:maxdepth: 2
99

10+
talent_v4/services
11+
talent_v4/types
1012
talent_v4beta1/services
1113
talent_v4beta1/types
12-
changelog
1314

1415
Migration Guide
1516
---------------
1617

17-
See the guide below for instructions on migrating to the 2.x release of this library.
18+
See the guide below for instructions on migrating to the 1.x release of this library.
1819

1920
.. toctree::
2021
:maxdepth: 2

docs/talent_v4/services.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
Services for Google Cloud Talent v4 API
2+
=======================================
3+
4+
.. automodule:: google.cloud.talent_v4.services.company_service
5+
:members:
6+
:inherited-members:
7+
.. automodule:: google.cloud.talent_v4.services.completion
8+
:members:
9+
:inherited-members:
10+
.. automodule:: google.cloud.talent_v4.services.event_service
11+
:members:
12+
:inherited-members:
13+
.. automodule:: google.cloud.talent_v4.services.job_service
14+
:members:
15+
:inherited-members:
16+
.. automodule:: google.cloud.talent_v4.services.tenant_service
17+
:members:
18+
:inherited-members:

docs/talent_v4/types.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Types for Google Cloud Talent v4 API
2+
====================================
3+
4+
.. automodule:: google.cloud.talent_v4.types
5+
:members:

google/cloud/talent/__init__.py

Lines changed: 75 additions & 205 deletions
Large diffs are not rendered by default.

google/cloud/talent_v4/__init__.py

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
# -*- coding: utf-8 -*-
2+
3+
# Copyright 2020 Google LLC
4+
#
5+
# Licensed under the Apache License, Version 2.0 (the "License");
6+
# you may not use this file except in compliance with the License.
7+
# You may obtain a copy of the License at
8+
#
9+
# http://www.apache.org/licenses/LICENSE-2.0
10+
#
11+
# Unless required by applicable law or agreed to in writing, software
12+
# distributed under the License is distributed on an "AS IS" BASIS,
13+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14+
# See the License for the specific language governing permissions and
15+
# limitations under the License.
16+
#
17+
18+
from .services.company_service import CompanyServiceClient
19+
from .services.completion import CompletionClient
20+
from .services.event_service import EventServiceClient
21+
from .services.job_service import JobServiceClient
22+
from .services.tenant_service import TenantServiceClient
23+
from .types.common import BatchOperationMetadata
24+
from .types.common import CommuteMethod
25+
from .types.common import CompanySize
26+
from .types.common import CompensationInfo
27+
from .types.common import CustomAttribute
28+
from .types.common import DegreeType
29+
from .types.common import DeviceInfo
30+
from .types.common import EmploymentType
31+
from .types.common import HtmlSanitization
32+
from .types.common import JobBenefit
33+
from .types.common import JobCategory
34+
from .types.common import JobLevel
35+
from .types.common import Location
36+
from .types.common import PostingRegion
37+
from .types.common import RequestMetadata
38+
from .types.common import ResponseMetadata
39+
from .types.common import SpellingCorrection
40+
from .types.common import TimestampRange
41+
from .types.common import Visibility
42+
from .types.company import Company
43+
from .types.company_service import CreateCompanyRequest
44+
from .types.company_service import DeleteCompanyRequest
45+
from .types.company_service import GetCompanyRequest
46+
from .types.company_service import ListCompaniesRequest
47+
from .types.company_service import ListCompaniesResponse
48+
from .types.company_service import UpdateCompanyRequest
49+
from .types.completion_service import CompleteQueryRequest
50+
from .types.completion_service import CompleteQueryResponse
51+
from .types.event import ClientEvent
52+
from .types.event import JobEvent
53+
from .types.event_service import CreateClientEventRequest
54+
from .types.filters import CommuteFilter
55+
from .types.filters import CompensationFilter
56+
from .types.filters import JobQuery
57+
from .types.filters import LocationFilter
58+
from .types.histogram import HistogramQuery
59+
from .types.histogram import HistogramQueryResult
60+
from .types.job import Job
61+
from .types.job_service import BatchCreateJobsRequest
62+
from .types.job_service import BatchCreateJobsResponse
63+
from .types.job_service import BatchDeleteJobsRequest
64+
from .types.job_service import BatchDeleteJobsResponse
65+
from .types.job_service import BatchUpdateJobsRequest
66+
from .types.job_service import BatchUpdateJobsResponse
67+
from .types.job_service import CreateJobRequest
68+
from .types.job_service import DeleteJobRequest
69+
from .types.job_service import GetJobRequest
70+
from .types.job_service import JobResult
71+
from .types.job_service import JobView
72+
from .types.job_service import ListJobsRequest
73+
from .types.job_service import ListJobsResponse
74+
from .types.job_service import SearchJobsRequest
75+
from .types.job_service import SearchJobsResponse
76+
from .types.job_service import UpdateJobRequest
77+
from .types.tenant import Tenant
78+
from .types.tenant_service import CreateTenantRequest
79+
from .types.tenant_service import DeleteTenantRequest
80+
from .types.tenant_service import GetTenantRequest
81+
from .types.tenant_service import ListTenantsRequest
82+
from .types.tenant_service import ListTenantsResponse
83+
from .types.tenant_service import UpdateTenantRequest
84+
85+
86+
__all__ = (
87+
"BatchCreateJobsRequest",
88+
"BatchCreateJobsResponse",
89+
"BatchDeleteJobsRequest",
90+
"BatchDeleteJobsResponse",
91+
"BatchOperationMetadata",
92+
"BatchUpdateJobsRequest",
93+
"BatchUpdateJobsResponse",
94+
"ClientEvent",
95+
"CommuteFilter",
96+
"CommuteMethod",
97+
"Company",
98+
"CompanyServiceClient",
99+
"CompanySize",
100+
"CompensationFilter",
101+
"CompensationInfo",
102+
"CompleteQueryRequest",
103+
"CompleteQueryResponse",
104+
"CompletionClient",
105+
"CreateClientEventRequest",
106+
"CreateCompanyRequest",
107+
"CreateJobRequest",
108+
"CreateTenantRequest",
109+
"CustomAttribute",
110+
"DegreeType",
111+
"DeleteCompanyRequest",
112+
"DeleteJobRequest",
113+
"DeleteTenantRequest",
114+
"DeviceInfo",
115+
"EmploymentType",
116+
"EventServiceClient",
117+
"GetCompanyRequest",
118+
"GetJobRequest",
119+
"GetTenantRequest",
120+
"HistogramQuery",
121+
"HistogramQueryResult",
122+
"HtmlSanitization",
123+
"Job",
124+
"JobBenefit",
125+
"JobCategory",
126+
"JobEvent",
127+
"JobLevel",
128+
"JobQuery",
129+
"JobResult",
130+
"JobServiceClient",
131+
"JobView",
132+
"ListCompaniesRequest",
133+
"ListCompaniesResponse",
134+
"ListJobsRequest",
135+
"ListJobsResponse",
136+
"ListTenantsRequest",
137+
"ListTenantsResponse",
138+
"Location",
139+
"LocationFilter",
140+
"PostingRegion",
141+
"RequestMetadata",
142+
"ResponseMetadata",
143+
"SearchJobsRequest",
144+
"SearchJobsResponse",
145+
"SpellingCorrection",
146+
"Tenant",
147+
"TimestampRange",
148+
"UpdateCompanyRequest",
149+
"UpdateJobRequest",
150+
"UpdateTenantRequest",
151+
"Visibility",
152+
"TenantServiceClient",
153+
)

0 commit comments

Comments
 (0)