Cloud Talent Solution V4beta1 API - Class Google::Cloud::Talent::V4beta1::Profile (v0.4.6)

Reference documentation and code samples for the Cloud Talent Solution V4beta1 API class Google::Cloud::Talent::V4beta1::Profile.

A resource that represents the profile for a job candidate (also referred to as a "single-source profile").

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#activities

def activities() -> ::Array<::Google::Cloud::Talent::V4beta1::Activity>
Returns

#activities=

def activities=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Activity>
Parameter
Returns

#additional_contact_info

def additional_contact_info() -> ::Array<::Google::Cloud::Talent::V4beta1::AdditionalContactInfo>
Returns

#additional_contact_info=

def additional_contact_info=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::AdditionalContactInfo>
Parameter
Returns

#addresses

def addresses() -> ::Array<::Google::Cloud::Talent::V4beta1::Address>
Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::Address>) —

    The candidate's postal addresses. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Provide Address.usage if possible, especially if the address is PERSONAL. During a search only personal addresses are considered. If there is no such address, all addresses with unspecified usage are assumed to be personal.
    • Provide Address.current for the current address if possible. During a search, only current addresses are considered. If there is no such address, all addresses are assumed to be current.

    When displaying a candidate's addresses, it is sometimes desirable to limit the number of addresses shown. In these cases we recommend that you display the addresses in the following order of priority:

    1. Address.usage is PERSONAL and Address.current is true.
    2. Address.usage is PERSONAL and Address.current is false or not set.
    3. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is true.
    4. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is false or not set.

#addresses=

def addresses=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Address>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4beta1::Address>) —

    The candidate's postal addresses. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Provide Address.usage if possible, especially if the address is PERSONAL. During a search only personal addresses are considered. If there is no such address, all addresses with unspecified usage are assumed to be personal.
    • Provide Address.current for the current address if possible. During a search, only current addresses are considered. If there is no such address, all addresses are assumed to be current.

    When displaying a candidate's addresses, it is sometimes desirable to limit the number of addresses shown. In these cases we recommend that you display the addresses in the following order of priority:

    1. Address.usage is PERSONAL and Address.current is true.
    2. Address.usage is PERSONAL and Address.current is false or not set.
    3. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is true.
    4. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is false or not set.
Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::Address>) —

    The candidate's postal addresses. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Provide Address.usage if possible, especially if the address is PERSONAL. During a search only personal addresses are considered. If there is no such address, all addresses with unspecified usage are assumed to be personal.
    • Provide Address.current for the current address if possible. During a search, only current addresses are considered. If there is no such address, all addresses are assumed to be current.

    When displaying a candidate's addresses, it is sometimes desirable to limit the number of addresses shown. In these cases we recommend that you display the addresses in the following order of priority:

    1. Address.usage is PERSONAL and Address.current is true.
    2. Address.usage is PERSONAL and Address.current is false or not set.
    3. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is true.
    4. Address.usage is CONTACT_INFO_USAGE_UNSPECIFIED and Address.current is false or not set.

#applications

def applications() -> ::Array<::String>
Returns
  • (::Array<::String>) — Output only. The resource names of the candidate's applications.

#assignments

def assignments() -> ::Array<::String>
Returns
  • (::Array<::String>) — Output only. The resource names of the candidate's assignments.

#availability_signals

def availability_signals() -> ::Array<::Google::Cloud::Talent::V4beta1::AvailabilitySignal>
Returns

#candidate_update_time

def candidate_update_time() -> ::Google::Protobuf::Timestamp
Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the profile was last updated as a result of a direct or indirect action by a candidate.

    These actions include:

    • Direct actions such as the candidate submitting a new resume as part of a job application to the agency, using a self-service tool such as a website to update their profile, and so on.
    • Indirect actions by the candidate such as uploading a resume to a job board that is collected by the agency through a feed, providing a resume to a recruiter who then uploads it into the ATS, and so on.
    • Updates made to the candidate's profile by the recruiter as a result of interacting with the candidate (for example adding a skill or work preference, and so on). Changes to [recruiting_notes][google.cloud.talent.v4beta1.Profile.recruiting_notes] are specifically excluded from this action type.

    Note: candidate_update_time must be greater than or equal to resume_update_time or an error is thrown.

#candidate_update_time=

def candidate_update_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
  • value (::Google::Protobuf::Timestamp) — The timestamp when the profile was last updated as a result of a direct or indirect action by a candidate.

    These actions include:

    • Direct actions such as the candidate submitting a new resume as part of a job application to the agency, using a self-service tool such as a website to update their profile, and so on.
    • Indirect actions by the candidate such as uploading a resume to a job board that is collected by the agency through a feed, providing a resume to a recruiter who then uploads it into the ATS, and so on.
    • Updates made to the candidate's profile by the recruiter as a result of interacting with the candidate (for example adding a skill or work preference, and so on). Changes to [recruiting_notes][google.cloud.talent.v4beta1.Profile.recruiting_notes] are specifically excluded from this action type.

    Note: candidate_update_time must be greater than or equal to resume_update_time or an error is thrown.

Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the profile was last updated as a result of a direct or indirect action by a candidate.

    These actions include:

    • Direct actions such as the candidate submitting a new resume as part of a job application to the agency, using a self-service tool such as a website to update their profile, and so on.
    • Indirect actions by the candidate such as uploading a resume to a job board that is collected by the agency through a feed, providing a resume to a recruiter who then uploads it into the ATS, and so on.
    • Updates made to the candidate's profile by the recruiter as a result of interacting with the candidate (for example adding a skill or work preference, and so on). Changes to [recruiting_notes][google.cloud.talent.v4beta1.Profile.recruiting_notes] are specifically excluded from this action type.

    Note: candidate_update_time must be greater than or equal to resume_update_time or an error is thrown.

#certifications

def certifications() -> ::Array<::Google::Cloud::Talent::V4beta1::Certification>
Returns

#certifications=

def certifications=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Certification>
Parameter
Returns

#create_time

def create_time() -> ::Google::Protobuf::Timestamp
Returns

#create_time=

def create_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
Returns

#custom_attributes

def custom_attributes() -> ::Google::Protobuf::Map{::String => ::Google::Cloud::Talent::V4beta1::CustomAttribute}
Returns
  • (::Google::Protobuf::Map{::String => ::Google::Cloud::Talent::V4beta1::CustomAttribute}) — A map of fields to hold both filterable and non-filterable custom profile attributes that aren't covered by the provided structured fields. See CustomAttribute for more details.

    At most 100 filterable and at most 100 unfilterable keys are supported. If limit is exceeded, an error is thrown. Custom attributes are unfilterable by default. These are filterable when the filterable flag is set to true.

    Numeric custom attributes: each key can only map to one numeric value, otherwise an error is thrown. Client can also filter on numeric custom attributes using '>', '<' or '=' operators.

    String custom attributes: each key can map up to 50 string values. For filterable string value, each value has a byte size of no more than 256B. For unfilterable string values, the maximum byte size of a single key is 64B. An error is thrown for any request exceeding the limit. The maximum total byte size is 10KB.

#custom_attributes=

def custom_attributes=(value) -> ::Google::Protobuf::Map{::String => ::Google::Cloud::Talent::V4beta1::CustomAttribute}
Parameter
  • value (::Google::Protobuf::Map{::String => ::Google::Cloud::Talent::V4beta1::CustomAttribute}) — A map of fields to hold both filterable and non-filterable custom profile attributes that aren't covered by the provided structured fields. See CustomAttribute for more details.

    At most 100 filterable and at most 100 unfilterable keys are supported. If limit is exceeded, an error is thrown. Custom attributes are unfilterable by default. These are filterable when the filterable flag is set to true.

    Numeric custom attributes: each key can only map to one numeric value, otherwise an error is thrown. Client can also filter on numeric custom attributes using '>', '<' or '=' operators.

    String custom attributes: each key can map up to 50 string values. For filterable string value, each value has a byte size of no more than 256B. For unfilterable string values, the maximum byte size of a single key is 64B. An error is thrown for any request exceeding the limit. The maximum total byte size is 10KB.

Returns
  • (::Google::Protobuf::Map{::String => ::Google::Cloud::Talent::V4beta1::CustomAttribute}) — A map of fields to hold both filterable and non-filterable custom profile attributes that aren't covered by the provided structured fields. See CustomAttribute for more details.

    At most 100 filterable and at most 100 unfilterable keys are supported. If limit is exceeded, an error is thrown. Custom attributes are unfilterable by default. These are filterable when the filterable flag is set to true.

    Numeric custom attributes: each key can only map to one numeric value, otherwise an error is thrown. Client can also filter on numeric custom attributes using '>', '<' or '=' operators.

    String custom attributes: each key can map up to 50 string values. For filterable string value, each value has a byte size of no more than 256B. For unfilterable string values, the maximum byte size of a single key is 64B. An error is thrown for any request exceeding the limit. The maximum total byte size is 10KB.

#derived_addresses

def derived_addresses() -> ::Array<::Google::Cloud::Talent::V4beta1::Location>
Returns

#education_records

def education_records() -> ::Array<::Google::Cloud::Talent::V4beta1::EducationRecord>
Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::EducationRecord>) — The education history record of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the education records.
    • List each education type separately, no matter how minor the change is. For example, the profile contains the education experience from the same school but different degrees.
    • Provide EducationRecord.is_current for the current education if possible. If not, it's inferred from user inputs.

    The limitation for max number of education records is 100.

#education_records=

def education_records=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::EducationRecord>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4beta1::EducationRecord>) — The education history record of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the education records.
    • List each education type separately, no matter how minor the change is. For example, the profile contains the education experience from the same school but different degrees.
    • Provide EducationRecord.is_current for the current education if possible. If not, it's inferred from user inputs.

    The limitation for max number of education records is 100.

Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::EducationRecord>) — The education history record of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the education records.
    • List each education type separately, no matter how minor the change is. For example, the profile contains the education experience from the same school but different degrees.
    • Provide EducationRecord.is_current for the current education if possible. If not, it's inferred from user inputs.

    The limitation for max number of education records is 100.

#email_addresses

def email_addresses() -> ::Array<::Google::Cloud::Talent::V4beta1::Email>
Returns

#email_addresses=

def email_addresses=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Email>
Parameter
Returns

#employment_records

def employment_records() -> ::Array<::Google::Cloud::Talent::V4beta1::EmploymentRecord>
Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::EmploymentRecord>) — The employment history records of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the employment records.
    • List different employment types separately, no matter how minor the change is. For example, only job title is changed from "software engineer" to "senior software engineer".
    • Provide EmploymentRecord.is_current for the current employment if possible. If not, it's inferred from user inputs.

    The limitation for max number of employment records is 100.

#employment_records=

def employment_records=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::EmploymentRecord>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4beta1::EmploymentRecord>) — The employment history records of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the employment records.
    • List different employment types separately, no matter how minor the change is. For example, only job title is changed from "software engineer" to "senior software engineer".
    • Provide EmploymentRecord.is_current for the current employment if possible. If not, it's inferred from user inputs.

    The limitation for max number of employment records is 100.

Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::EmploymentRecord>) — The employment history records of the candidate. It's highly recommended to input this information as accurately as possible to help improve search quality. Here are some recommendations:

    • Specify the start and end dates of the employment records.
    • List different employment types separately, no matter how minor the change is. For example, only job title is changed from "software engineer" to "senior software engineer".
    • Provide EmploymentRecord.is_current for the current employment if possible. If not, it's inferred from user inputs.

    The limitation for max number of employment records is 100.

#external_id

def external_id() -> ::String
Returns
  • (::String) — Profile's id in client system, if available. This value is unique for each profile inside a tenant. An error is thrown if another profile with the same external_id is created.

    The maximum number of bytes allowed is 100.

#external_id=

def external_id=(value) -> ::String
Parameter
  • value (::String) — Profile's id in client system, if available. This value is unique for each profile inside a tenant. An error is thrown if another profile with the same external_id is created.

    The maximum number of bytes allowed is 100.

Returns
  • (::String) — Profile's id in client system, if available. This value is unique for each profile inside a tenant. An error is thrown if another profile with the same external_id is created.

    The maximum number of bytes allowed is 100.

#group_id

def group_id() -> ::String
Returns
  • (::String) — The cluster id of the profile to associate with other profile(s) for the same candidate.

    This field should be generated by the customer. If a value is not provided, a random UUID is assigned to this field of the profile.

    This is used to link multiple profiles to the same candidate. For example, a client has a candidate with two profiles, where one was created recently and the other one was created 5 years ago. These two profiles may be very different. The clients can create the first profile and get a generated group_id, and assign it when the second profile is created, indicating these two profiles are referring to the same candidate.

#group_id=

def group_id=(value) -> ::String
Parameter
  • value (::String) — The cluster id of the profile to associate with other profile(s) for the same candidate.

    This field should be generated by the customer. If a value is not provided, a random UUID is assigned to this field of the profile.

    This is used to link multiple profiles to the same candidate. For example, a client has a candidate with two profiles, where one was created recently and the other one was created 5 years ago. These two profiles may be very different. The clients can create the first profile and get a generated group_id, and assign it when the second profile is created, indicating these two profiles are referring to the same candidate.

Returns
  • (::String) — The cluster id of the profile to associate with other profile(s) for the same candidate.

    This field should be generated by the customer. If a value is not provided, a random UUID is assigned to this field of the profile.

    This is used to link multiple profiles to the same candidate. For example, a client has a candidate with two profiles, where one was created recently and the other one was created 5 years ago. These two profiles may be very different. The clients can create the first profile and get a generated group_id, and assign it when the second profile is created, indicating these two profiles are referring to the same candidate.

#is_hirable

def is_hirable() -> ::Google::Protobuf::BoolValue
Returns

#is_hirable=

def is_hirable=(value) -> ::Google::Protobuf::BoolValue
Parameter
Returns

#keyword_snippet

def keyword_snippet() -> ::String
Returns
  • (::String) — Output only. Keyword snippet shows how the search result is related to a search query. This is only returned in SearchProfilesResponse.

#name

def name() -> ::String
Returns
  • (::String) — Required during profile update.

    Resource name assigned to a profile by the API.

    The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for example, "projects/foo/tenants/bar/profiles/baz".

#name=

def name=(value) -> ::String
Parameter
  • value (::String) — Required during profile update.

    Resource name assigned to a profile by the API.

    The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for example, "projects/foo/tenants/bar/profiles/baz".

Returns
  • (::String) — Required during profile update.

    Resource name assigned to a profile by the API.

    The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for example, "projects/foo/tenants/bar/profiles/baz".

#patents

def patents() -> ::Array<::Google::Cloud::Talent::V4beta1::Patent>
Returns

#patents=

def patents=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Patent>
Parameter
Returns

#person_names

def person_names() -> ::Array<::Google::Cloud::Talent::V4beta1::PersonName>
Returns

#person_names=

def person_names=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::PersonName>
Parameter
Returns

#personal_uris

def personal_uris() -> ::Array<::Google::Cloud::Talent::V4beta1::PersonalUri>
Returns

#personal_uris=

def personal_uris=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::PersonalUri>
Parameter
Returns

#phone_numbers

def phone_numbers() -> ::Array<::Google::Cloud::Talent::V4beta1::Phone>
Returns

#phone_numbers=

def phone_numbers=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Phone>
Parameter
Returns

#processed

def processed() -> ::Boolean
Returns
  • (::Boolean) — Output only. Indicates if a summarized profile was created as part of the profile creation API call. This flag does not indicate whether a profile is searchable or not.

#publications

def publications() -> ::Array<::Google::Cloud::Talent::V4beta1::Publication>
Returns

#publications=

def publications=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Publication>
Parameter
Returns

#resume

def resume() -> ::Google::Cloud::Talent::V4beta1::Resume
Returns

#resume=

def resume=(value) -> ::Google::Cloud::Talent::V4beta1::Resume
Parameter
Returns

#resume_update_time

def resume_update_time() -> ::Google::Protobuf::Timestamp
Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the candidate's resume was added or updated on the candidate's profile. Whether that resume was directly uploaded by a candidate, pulled from a 3rd party job board feed, added by a recruiter, and so on.

    If this field is updated, it's expected that resume is provided in the create or update calls.

#resume_update_time=

def resume_update_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
  • value (::Google::Protobuf::Timestamp) — The timestamp when the candidate's resume was added or updated on the candidate's profile. Whether that resume was directly uploaded by a candidate, pulled from a 3rd party job board feed, added by a recruiter, and so on.

    If this field is updated, it's expected that resume is provided in the create or update calls.

Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the candidate's resume was added or updated on the candidate's profile. Whether that resume was directly uploaded by a candidate, pulled from a 3rd party job board feed, added by a recruiter, and so on.

    If this field is updated, it's expected that resume is provided in the create or update calls.

#skills

def skills() -> ::Array<::Google::Cloud::Talent::V4beta1::Skill>
Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::Skill>) — The skill set of the candidate. It's highly recommended to provide as much information as possible to help improve the search quality.

    The limitation for max number of skills is 500.

#skills=

def skills=(value) -> ::Array<::Google::Cloud::Talent::V4beta1::Skill>
Parameter
  • value (::Array<::Google::Cloud::Talent::V4beta1::Skill>) — The skill set of the candidate. It's highly recommended to provide as much information as possible to help improve the search quality.

    The limitation for max number of skills is 500.

Returns
  • (::Array<::Google::Cloud::Talent::V4beta1::Skill>) — The skill set of the candidate. It's highly recommended to provide as much information as possible to help improve the search quality.

    The limitation for max number of skills is 500.

#source

def source() -> ::String
Returns
  • (::String) — The source description indicating where the profile is acquired.

    For example, if a candidate profile is acquired from a resume, the user can input "resume" here to indicate the source.

    The maximum number of bytes allowed is 100.

#source=

def source=(value) -> ::String
Parameter
  • value (::String) — The source description indicating where the profile is acquired.

    For example, if a candidate profile is acquired from a resume, the user can input "resume" here to indicate the source.

    The maximum number of bytes allowed is 100.

Returns
  • (::String) — The source description indicating where the profile is acquired.

    For example, if a candidate profile is acquired from a resume, the user can input "resume" here to indicate the source.

    The maximum number of bytes allowed is 100.

#update_time

def update_time() -> ::Google::Protobuf::Timestamp
Returns

#update_time=

def update_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
Returns

#uri

def uri() -> ::String
Returns
  • (::String) — The URI set by clients that links to this profile's client-side copy.

    The maximum number of bytes allowed is 4000.

#uri=

def uri=(value) -> ::String
Parameter
  • value (::String) — The URI set by clients that links to this profile's client-side copy.

    The maximum number of bytes allowed is 4000.

Returns
  • (::String) — The URI set by clients that links to this profile's client-side copy.

    The maximum number of bytes allowed is 4000.