Class: Google::Apis::JobsV3p1beta1::CloudTalentSolutionService

Inherits:
Core::BaseService show all
Defined in:
generated/google/apis/jobs_v3p1beta1/service.rb

Overview

Cloud Talent Solution API

Cloud Talent Solution provides the capability to create, read, update, and delete job postings, as well as search jobs based on keywords and filters.

Examples:

require 'google/apis/jobs_v3p1beta1'

Jobs = Google::Apis::JobsV3p1beta1 # Alias the module
service = Jobs::CloudTalentSolutionService.new

See Also:

Instance Attribute Summary collapse

Attributes inherited from Core::BaseService

#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path

Instance Method Summary collapse

Methods inherited from Core::BaseService

#batch, #batch_upload, #fetch_all, #http

Methods included from Core::Logging

#logger

Constructor Details

#initialize ⇒ CloudTalentSolutionService

Returns a new instance of CloudTalentSolutionService



46
47
48
49
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 46

def initialize
  super('https://jobs.googleapis.com/', '')
  @batch_path = 'batch'
end

Instance Attribute Details

#key ⇒ String

Returns API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

Returns:

  • (String) —

    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.



39
40
41
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 39

def key
  @key
end

#quota_user ⇒ String

Returns Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

Returns:

  • (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.



44
45
46
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 44

def quota_user
  @quota_user
end

Instance Method Details

#batch_delete_jobs(parent, batch_delete_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Empty

Deletes a list of Jobs by filter.

Parameters:

  • parent (String) —

    Required. The resource name of the project under which the job is created. The format is "projects/project_id", for example, "projects/api-test-project".

  • batch_delete_jobs_request_object (Google::Apis::JobsV3p1beta1::BatchDeleteJobsRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



397
398
399
400
401
402
403
404
405
406
407
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 397

def batch_delete_jobs(parent, batch_delete_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/jobs:batchDelete', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::BatchDeleteJobsRequest::Representation
  command.request_object = batch_delete_jobs_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::Empty::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Empty
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#complete_project(name, company_name: nil, language_code: nil, language_codes: nil, page_size: nil, query: nil, scope: nil, type: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::CompleteQueryResponse

Completes the specified prefix with keyword suggestions. Intended for use by a job search auto-complete search box.

Parameters:

  • name (String) —

    Required. Resource name of project the completion is performed within. The format is "projects/project_id", for example, "projects/api-test-project".

  • company_name (String) —

    Optional. If provided, restricts completion to specified company. The format is "projects/project_id/companies/company_id", for example, "projects/api-test-project/companies/foo".

  • language_code (String) —

    Deprecated. Use language_codes instead. Optional. The language of the query. This is the BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages. For CompletionType.JOB_TITLE type, only open jobs with the same language_code are returned. For CompletionType.COMPANY_NAME type, only companies having open jobs with the same language_code are returned. For CompletionType.COMBINED type, only open jobs with the same language_code or companies having open jobs with the same language_code are returned. The maximum number of allowed characters is 255.

  • language_codes (Array<String>, String) —

    Optional. The list of languages of the query. This is the BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Tags for Identifying Languages. For CompletionType.JOB_TITLE type, only open jobs with the same language_codes are returned. For CompletionType.COMPANY_NAME type, only companies having open jobs with the same language_codes are returned. For CompletionType.COMBINED type, only open jobs with the same language_codes or companies having open jobs with the same language_codes are returned. The maximum number of allowed characters is 255.

  • page_size (Fixnum) —

    Required. Completion result count. The maximum allowed page size is 10.

  • query (String) —

    Required. The query used to generate suggestions. The maximum number of allowed characters is 255.

  • scope (String) —

    Optional. The scope of the completion. The defaults is CompletionScope.PUBLIC.

  • type (String) —

    Optional. The completion topic. The default is CompletionType.COMBINED.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 125

def complete_project(name, company_name: nil, language_code: nil, language_codes: nil, page_size: nil, query: nil, scope: nil, type: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+name}:complete', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::CompleteQueryResponse::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::CompleteQueryResponse
  command.params['name'] = name unless name.nil?
  command.query['companyName'] = company_name unless company_name.nil?
  command.query['languageCode'] = language_code unless language_code.nil?
  command.query['languageCodes'] = language_codes unless language_codes.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['query'] = query unless query.nil?
  command.query['scope'] = scope unless scope.nil?
  command.query['type'] = type unless type.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_client_event(parent, create_client_event_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::ClientEvent

Report events issued when end user interacts with customer's application that uses Cloud Talent Solution. You may inspect the created events in self service tools. Learn more about self service tools.

Parameters:

  • parent (String) —

    Parent project name.

  • create_client_event_request_object (Google::Apis::JobsV3p1beta1::CreateClientEventRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



170
171
172
173
174
175
176
177
178
179
180
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 170

def create_client_event(parent, create_client_event_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/clientEvents', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::CreateClientEventRequest::Representation
  command.request_object = create_client_event_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::ClientEvent::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::ClientEvent
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_company(parent, create_company_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Company

Creates a new company entity.

Parameters:

  • parent (String) —

    Required. Resource name of the project under which the company is created. The format is "projects/project_id", for example, "projects/api-test-project".

  • create_company_request_object (Google::Apis::JobsV3p1beta1::CreateCompanyRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



206
207
208
209
210
211
212
213
214
215
216
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 206

def create_company(parent, create_company_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/companies', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::CreateCompanyRequest::Representation
  command.request_object = create_company_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::Company::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Company
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_job(parent, create_job_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Job

Creates a new job. Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes.

Parameters:

  • parent (String) —

    Required. The resource name of the project under which the job is created. The format is "projects/project_id", for example, "projects/api-test-project".

  • create_job_request_object (Google::Apis::JobsV3p1beta1::CreateJobRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



435
436
437
438
439
440
441
442
443
444
445
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 435

def create_job(parent, create_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/jobs', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::CreateJobRequest::Representation
  command.request_object = create_job_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::Job::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Job
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#delete_project_company(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Empty

Deletes specified company. Prerequisite: The company has no jobs associated with it.

Parameters:

  • name (String) —

    Required. The resource name of the company to be deleted. The format is "projects/project_id/companies/company_id", for example, "projects/api-test-project/companies/foo".

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



242
243
244
245
246
247
248
249
250
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 242

def delete_project_company(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:delete, 'v3p1beta1/{+name}', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::Empty::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Empty
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#delete_project_job(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Empty

Deletes the specified job. Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes.

Parameters:

  • name (String) —

    Required. The resource name of the job to be deleted. The format is "projects/project_id/jobs/job_id", for example, "projects/api-test-project/jobs/1234".

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



472
473
474
475
476
477
478
479
480
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 472

def delete_project_job(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:delete, 'v3p1beta1/{+name}', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::Empty::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Empty
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_company(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Company

Retrieves specified company.

Parameters:

  • name (String) —

    Required. The resource name of the company to be retrieved. The format is "projects/project_id/companies/company_id", for example, "projects/api-test-project/companies/foo".

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



275
276
277
278
279
280
281
282
283
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 275

def get_project_company(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+name}', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::Company::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Company
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_job(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Job

Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days.

Parameters:

  • name (String) —

    Required. The resource name of the job to retrieve. The format is "projects/project_id/jobs/job_id", for example, "projects/api-test-project/jobs/1234".

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



506
507
508
509
510
511
512
513
514
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 506

def get_project_job(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+name}', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::Job::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Job
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_operation(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Operation

Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

Parameters:

  • name (String) —

    The name of the operation resource.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



723
724
725
726
727
728
729
730
731
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 723

def get_project_operation(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+name}', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::Operation::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Operation
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_companies(parent, page_size: nil, page_token: nil, require_open_jobs: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::ListCompaniesResponse

Lists all companies associated with the service account.

Parameters:

  • parent (String) —

    Required. Resource name of the project under which the company is created. The format is "projects/project_id", for example, "projects/api-test-project".

  • page_size (Fixnum) —

    Optional. The maximum number of companies to be returned, at most 100. Default is 100 if a non-positive number is provided.

  • page_token (String) —

    Optional. The starting indicator from which to return results.

  • require_open_jobs (Boolean) —

    Optional. Set to true if the companies requested must have open jobs. Defaults to false. If true, at most page_size of companies are fetched, among which only those with open jobs are returned.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



321
322
323
324
325
326
327
328
329
330
331
332
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 321

def list_project_companies(parent, page_size: nil, page_token: nil, require_open_jobs: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+parent}/companies', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::ListCompaniesResponse::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::ListCompaniesResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['requireOpenJobs'] = require_open_jobs unless require_open_jobs.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_jobs(parent, filter: nil, job_view: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::ListJobsResponse

Lists jobs by filter.

Parameters:

  • parent (String) —

    Required. The resource name of the project under which the job is created. The format is "projects/project_id", for example, "projects/api-test-project".

  • filter (String) —

    Required. The filter string specifies the jobs to be enumerated. Supported operator: =, AND The fields eligible for filtering are:

    • companyName (Required)
    • requisitionId (Optional) Sample Query:
    • companyName = "projects/api-test-project/companies/123"
    • companyName = "projects/api-test-project/companies/123" AND requisitionId = "req-1"
  • job_view (String) —

    Optional. The desired job attributes returned for jobs in the search response. Defaults to JobView.JOB_VIEW_FULL if no value is specified.

  • page_size (Fixnum) —

    Optional. The maximum number of jobs to be returned per page of results. If job_view is set to JobView.JOB_VIEW_ID_ONLY, the maximum allowed page size is 1000. Otherwise, the maximum allowed page size is 100. Default is 100 if empty or a number < 1 is specified.

  • page_token (String) —

    Optional. The starting point of a query result.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



564
565
566
567
568
569
570
571
572
573
574
575
576
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 564

def list_project_jobs(parent, filter: nil, job_view: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v3p1beta1/{+parent}/jobs', options)
  command.response_representation = Google::Apis::JobsV3p1beta1::ListJobsResponse::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::ListJobsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['filter'] = filter unless filter.nil?
  command.query['jobView'] = job_view unless job_view.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#patch_project_company(name, update_company_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Company

Updates specified company. Company names can't be updated. To update a company name, delete the company and all jobs associated with it, and only then re-create them.

Parameters:

  • name (String) —

    Required during company update. The resource name for a company. This is generated by the service when a company is created. The format is "projects/project_id/companies/company_id", for example, "projects/api-test-project/companies/foo".

  • update_company_request_object (Google::Apis::JobsV3p1beta1::UpdateCompanyRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



361
362
363
364
365
366
367
368
369
370
371
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 361

def patch_project_company(name, update_company_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:patch, 'v3p1beta1/{+name}', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::UpdateCompanyRequest::Representation
  command.request_object = update_company_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::Company::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Company
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#patch_project_job(name, update_job_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::Job

Updates specified job. Typically, updated contents become visible in search results within 10 seconds, but it may take up to 5 minutes.

Parameters:

  • name (String) —

    Required during job update. The resource name for the job. This is generated by the service when a job is created. The format is "projects/project_id/jobs/job_id", for example, "projects/api-test-project/jobs/1234". Use of this field in job queries and API calls is preferred over the use of requisition_id since this value is unique.

  • update_job_request_object (Google::Apis::JobsV3p1beta1::UpdateJobRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



607
608
609
610
611
612
613
614
615
616
617
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 607

def patch_project_job(name, update_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:patch, 'v3p1beta1/{+name}', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::UpdateJobRequest::Representation
  command.request_object = update_job_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::Job::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::Job
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#search_jobs(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::SearchJobsResponse

Searches for jobs using the provided SearchJobsRequest. This call constrains the visibility of jobs present in the database, and only returns jobs that the caller has permission to search against.

Parameters:

  • parent (String) —

    Required. The resource name of the project to search within. The format is "projects/project_id", for example, "projects/api-test-project".

  • search_jobs_request_object (Google::Apis::JobsV3p1beta1::SearchJobsRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



646
647
648
649
650
651
652
653
654
655
656
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 646

def search_jobs(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/jobs:search', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::SearchJobsRequest::Representation
  command.request_object = search_jobs_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::SearchJobsResponse::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::SearchJobsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#search_project_job_for_alert(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::JobsV3p1beta1::SearchJobsResponse

Searches for jobs using the provided SearchJobsRequest. This API call is intended for the use case of targeting passive job seekers (for example, job seekers who have signed up to receive email alerts about potential job opportunities), and has different algorithmic adjustments that are targeted to passive job seekers. This call constrains the visibility of jobs present in the database, and only returns jobs the caller has permission to search against.

Parameters:

  • parent (String) —

    Required. The resource name of the project to search within. The format is "projects/project_id", for example, "projects/api-test-project".

  • search_jobs_request_object (Google::Apis::JobsV3p1beta1::SearchJobsRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



689
690
691
692
693
694
695
696
697
698
699
 
# File 'generated/google/apis/jobs_v3p1beta1/service.rb', line 689

def search_project_job_for_alert(parent, search_jobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v3p1beta1/{+parent}/jobs:searchForAlert', options)
  command.request_representation = Google::Apis::JobsV3p1beta1::SearchJobsRequest::Representation
  command.request_object = search_jobs_request_object
  command.response_representation = Google::Apis::JobsV3p1beta1::SearchJobsResponse::Representation
  command.response_class = Google::Apis::JobsV3p1beta1::SearchJobsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end