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

Commit

Permalink
feat: add v4 (#29)
Browse files Browse the repository at this point in the history
  • Loading branch information
busunkim96 committed Sep 28, 2020
1 parent ef045e8 commit 80bef1f
Show file tree
Hide file tree
Showing 132 changed files with 31,099 additions and 2,636 deletions.
54 changes: 53 additions & 1 deletion UPGRADING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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:
# ...
```
7 changes: 4 additions & 3 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
18 changes: 18 additions & 0 deletions docs/talent_v4/services.rst
Original file line number Diff line number Diff line change
@@ -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:
5 changes: 5 additions & 0 deletions docs/talent_v4/types.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
Types for Google Cloud Talent v4 API
====================================

.. automodule:: google.cloud.talent_v4.types
:members:
280 changes: 75 additions & 205 deletions google/cloud/talent/__init__.py

Large diffs are not rendered by default.

153 changes: 153 additions & 0 deletions google/cloud/talent_v4/__init__.py
Original file line number Diff line number Diff line change
@@ -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",
)
Loading

0 comments on commit 80bef1f

Please sign in to comment.