Package google.cloud.talent.v4beta1

Index

CompanyService

Service qui gère la gestion de l'entreprise, y compris les opérations CRUD et l'énumération.

CreateCompany

rpc CreateCompany(CreateCompanyRequest) returns (Company)

Crée une entreprise.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteCompany

rpc DeleteCompany(DeleteCompanyRequest) returns (Empty)

Supprime l'entreprise spécifiée. Celle-ci ne doit être associée à aucune offre d'emploi.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetCompany

rpc GetCompany(GetCompanyRequest) returns (Company)

Récupère l'entreprise spécifiée.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListCompanies

rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse)

Répertorie toutes les entreprises associées au projet.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateCompany

rpc UpdateCompany(UpdateCompanyRequest) returns (Company)

Met à jour l'entreprise spécifiée.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

Completion

Un service gère la saisie semi-automatique.

CompleteQuery

rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse)

Complète le préfixe spécifié par des suggestions de mots clés. Destiné à être utilisé avec les champs de recherche d'offres d'emploi à saisie semi-automatique.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

EventService

Un service gère le rapport des événements client.

CreateClientEvent

rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent)

Rapporte les événements émis lorsque l'utilisateur final interagit avec l'application du client qui exploite Cloud Talent Solution. Vous pouvez inspecter les événements créés à l'aide des outils en libre-service. En savoir plus sur les outils en libre-service

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

JobService

Un service gère la gestion des offres d'emploi, y compris l'opération CRUD, l'énumération et la recherche d'emplois.

BatchCreateJobs

rpc BatchCreateJobs(BatchCreateJobsRequest) returns (Operation)

Démarre l'exécution d'une opération de création de tâches par lots.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

BatchDeleteJobs

rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (Empty)

Supprime une liste d'éléments Job par filtre.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

BatchUpdateJobs

rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (Operation)

Démarre l'exécution d'une opération de mise à jour par lots pour les jobs.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateJob

rpc CreateJob(CreateJobRequest) returns (Job)

Crée une offre d'emploi.

En général, la recherche est activée pour cette offre d'emploi dans les 10 secondes qui suivent sa création. Toutefois, cette opération peut prendre jusqu'à 5 minutes.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteJob

rpc DeleteJob(DeleteJobRequest) returns (Empty)

Supprime l'offre d'emploi spécifiée.

En général, la recherche est désactivée pour cette offre d'emploi dans les 10 secondes qui suivent sa création. Toutefois, cette opération peut prendre jusqu'à 5 minutes.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetJob

rpc GetJob(GetJobRequest) returns (Job)

Récupère l'offre d'emploi spécifiée, dont l'état est OPEN ou recently EXPIRED au cours des 90 derniers jours.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListJobs

rpc ListJobs(ListJobsRequest) returns (ListJobsResponse)

Répertorie les offres d'emploi par filtre.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

SearchJobs

rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse)

Recherche des offres d'emploi à l'aide du SearchJobsRequest fourni.

Cet appel limite le visibility des offres d'emploi présentes dans la base de données et ne renvoie que celles que l'appelant est autorisé à rechercher.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

SearchJobsForAlert

rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse)

Recherche des offres d'emploi à l'aide du SearchJobsRequest fourni.

Cet appel d'API cible les chercheurs d'emploi passifs (par exemple, ceux qui se sont inscrits pour recevoir des alertes par e-mail concernant des postes à pourvoir). Son algorithme prend en compte les spécificités de ce public.

Cet appel limite le visibility des offres d'emploi présentes dans la base de données et ne renvoie que celles que l'appelant est autorisé à rechercher.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateJob

rpc UpdateJob(UpdateJobRequest) returns (Job)

Met à jour l'offre d'emploi spécifiée.

En règle générale, les contenus mis à jour deviennent visibles dans les résultats de recherche en moins de 10 secondes, mais cela peut durer jusqu'à 5 minutes.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

TenantService

Service qui gère la gestion des locataires, y compris les opérations CRUD et l'énumération.

CreateTenant

rpc CreateTenant(CreateTenantRequest) returns (Tenant)

Crée une entité locataire.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteTenant

rpc DeleteTenant(DeleteTenantRequest) returns (Empty)

Supprime le locataire spécifié.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetTenant

rpc GetTenant(GetTenantRequest) returns (Tenant)

Récupère le locataire spécifié.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListTenants

rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse)

Répertorie tous les locataires associés au projet.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateTenant

rpc UpdateTenant(UpdateTenantRequest) returns (Tenant)

Met à jour le locataire spécifié.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/jobs
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

BatchCreateJobsRequest

Requête pour créer un lot de jobs.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel le job est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

jobs[]

Job

Obligatoire. Jobs à créer.

BatchDeleteJobsRequest

Requête de suppression par lot d'offres d'emploi.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel le job est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

filter

string

Obligatoire. La chaîne de filtres indique les offres d'emploi à supprimer.

Opérateur accepté : =, AND

Les champs permettant le filtrage sont les suivants :

  • companyName (obligatoire)
  • requisitionId (obligatoire)

Exemple de requête: companyName = "projects/foo/companies/bar" AND requisitionId = "req-1"

BatchOperationMetadata

Métadonnées utilisées pour les opérations de longue durée renvoyées par les API par lot CTS. Permet de remplacer google.longrunning.Operation.metadata.

Champs
state

State

État d'une opération de longue durée.

state_description

string

Informations plus détaillées sur l'état de l'opération.

success_count

int32

Nombre d'éléments réussis dans une opération.

failure_count

int32

Nombre d'éléments ayant échoué dans une opération.

total_count

int32

Nombre total d'éléments dans une opération.

create_time

Timestamp

Heure de création de l'opération par lot.

update_time

Timestamp

Heure à laquelle l'état de l'opération groupée est mis à jour. Les métadonnées et le update_time sont actualisés toutes les minutes. Sinon, les données mises en cache sont renvoyées.

end_time

Timestamp

Heure à laquelle l'opération groupée est terminée et où google.longrunning.Operation.done est défini sur true.

État

Enums
STATE_UNSPECIFIED Valeur par défaut.
INITIALIZING L'opération par lot est en cours de préparation pour le traitement.
PROCESSING L'opération par lot est en cours de traitement.
SUCCEEDED L'opération groupée est traitée, et au moins un élément a bien été traité.
FAILED L'opération groupée est terminée, et aucun élément n'a été traité correctement.
CANCELLING L'opération par lot est en cours d'annulation après l'appel de google.longrunning.Operations.CancelOperation.
CANCELLED L'opération par lot est effectuée après l'appel de google.longrunning.Operations.CancelOperation. Tous les articles traités avant l'annulation sont renvoyés dans la réponse.

BatchUpdateJobsRequest

Requête de mise à jour d'un lot de jobs.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel le job est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

jobs[]

Job

Obligatoire. Jobs à mettre à jour.

update_mask

FieldMask

Fortement recommandé pour une expérience de service optimale. Sachez que cela entraîne également une augmentation de la latence lors de la vérification de l'état d'une opération par lot.

Si update_mask est fourni, seuls les champs spécifiés dans Job sont mis à jour. Sinon, tous les champs sont mis à jour.

Masque de champ permettant de restreindre les champs mis à jour. Seuls les champs de premier niveau de Job sont acceptés.

Si update_mask est fourni, le Job dans JobResult ne contient que les champs mis à jour et l'ID de l'offre d'emploi. Sinon, Job inclura tous les champs, ce qui peut générer une réponse très volumineuse.

ClientEvent

Événement émis lorsque l'utilisateur final interagit avec l'application qui met en œuvre Cloud Talent Solution. Fournir ces informations améliore la qualité des résultats pour les clients API, ce qui permet au service de fonctionner de manière optimale. Le nombre d'événements envoyés doit être cohérent avec les autres appels, tels que les recherches d'emploi, émis au service par le client.

Champs
request_id

string

Fortement recommandé pour une expérience de service optimale.

ID unique généré dans les réponses d'API. Il se trouve dans ResponseMetadata.request_id.

event_id

string

Obligatoire. Un identifiant unique généré par l'application cliente.

create_time

Timestamp

Obligatoire. Horodatage de l'événement.

event_notes

string

Notes sur l'événement fournies par les recruteurs ou d'autres utilisateurs, par exemple un feedback sur la raison pour laquelle un profil a été mis en signet.

job_event

JobEvent

Événement émis lorsqu'un demandeur d'emploi interagit avec l'application qui met en œuvre Cloud Talent Solution.

CommuteFilter

Paramètres requis pour la recherche basée sur le temps de trajet domicile-travail.

Champs
commute_method

CommuteMethod

Obligatoire. Moyen de transport pour lequel calculer le temps de trajet domicile-travail.

start_coordinates

LatLng

Obligatoire. Latitude et longitude du lieu à partir duquel calculer le temps de trajet.

travel_duration

Duration

Obligatoire. Durée maximale du trajet en secondes. La valeur maximale autorisée est de 3600s (une heure). Le format est le suivant : 123s.

allow_imprecise_addresses

bool

Si la valeur est true, les offres d'emploi sans adresse postale peuvent également être renvoyées. Pour des adresses ne comportant qu'un nom de ville, le centre-ville est pris en compte. Pour les États ou les localisations plus larges, la correspondance textuelle est utilisée. Si ce champ est défini sur false ou n'est pas spécifié, seules les offres d'emploi comportant des adresses postales sont renvoyées par la recherche basée sur le temps de trajet domicile-travail.

Champ d'union traffic_option. Facteur de trafic à prendre en compte lors de la recherche par trajet domicile-travail. traffic_option ne peut être qu'un des éléments suivants :
road_traffic

RoadTraffic

Spécifie la densité du trafic à utiliser pour le calcul du temps de trajet domicile-travail.

departure_time

TimeOfDay

Heure de départ utilisée pour calculer l'impact du trafic, représentée par google.type.TimeOfDay dans le fuseau horaire local.

Actuellement, le modèle de trafic est limité à la résolution au niveau de l'heure.

RoadTraffic

Densité du trafic à prendre en compte pour le calcul du temps de trajet domicile-travail.

Enums
ROAD_TRAFFIC_UNSPECIFIED La situation du trafic routier n'est pas spécifiée.
TRAFFIC_FREE Il s'agit du temps de trajet domicile-travail optimal sans tenir compte de l'impact du trafic.
BUSY_HOUR Le calcul du temps de trajet domicile-travail prend en compte l'impact du trafic en période de pointe.

CommuteMethod

Méthode de recherche basée sur le temps de trajet domicile-travail.

Énumérations
COMMUTE_METHOD_UNSPECIFIED La méthode basée sur le temps de trajet domicile-travail n'est pas spécifiée.
DRIVING Le temps de trajet domicile-travail est calculé en fonction du temps de conduite.
TRANSIT Le temps de trajet domicile-travail est calculé en fonction des transports en commun, y compris le bus, le métro, le métro, etc.
WALKING Le temps de trajet domicile-travail est calculé en fonction du temps de marche.
CYCLING Le temps de trajet domicile-travail est calculé en fonction du temps à vélo.

Entreprise

Une ressource Company représente une entreprise au sein du service. Une entreprise est l'entité qui détient les offres d'emploi, c'est-à-dire l'entité responsable du recrutement des candidats.

Champs
name

string

Obligatoire pendant la mise à jour de l'entreprise.

Nom de ressource d'une entreprise. Il est généré par le service lors de la création de l'entreprise.

Ce format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/foo/tenants/bar/companies/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/companies/bar".

display_name

string

Obligatoire. Nom à afficher de l'entreprise (par exemple, "Google LLC").

external_id

string

Obligatoire. ID d'entreprise côté client, permettant d'identifier de manière unique l'entreprise.

Le nombre maximal de caractères autorisés est de 255.

size

CompanySize

Taille de l'entreprise de l'employeur.

headquarters_address

string

Adresse postale du siège social de l'entreprise, qui peut être différente de la zone géographique du poste à pourvoir. Le service tente de géolocaliser l'adresse et renseigne une zone géographique plus spécifique dans la mesure du possible, dans DerivedInfo.headquarters_location.

hiring_agency

bool

La valeur est définie sur "true" si l'agence de recrutement publie des offres d'emploi pour le compte d'employeurs.

La valeur par défaut est "false" si aucune valeur n'est fournie.

eeo_text

string

Clause de non-responsabilité relative à l'égalité d'accès au travail, à associer à toutes les offres d'emploi de cette entreprise et à afficher, en règle générale, pour tous les postes.

Le nombre maximal de caractères autorisés est de 500.

website_uri

string

URI représentant le site Web principal ou la page d'accueil de l'entreprise. Par exemple : "https://www.google.com".

Le nombre maximal de caractères autorisés est de 255.

career_site_uri

string

URI du site de recrutement de l'employeur ou de la page des offres d'emploi du site Web de l'employeur. Par exemple : "https://careers.google.com".

image_uri

string

URI hébergeant le logo de l'entreprise de l'employeur.

keyword_searchable_job_custom_attributes[]

string

Liste de clés de Job.custom_attributes filtrables, dont les string_values correspondantes sont utilisées dans les recherches par mots clés. Les offres d'emploi contenant string_values sous ces clés de champ spécifiées sont renvoyées si l'une des valeurs correspond au mot clé de recherche. Les valeurs des champs personnalisés comportant des parenthèses, des crochets et des symboles spéciaux ne peuvent pas faire l'objet de recherches telles quelles, et ces requêtes de mots clés doivent être entourées de guillemets.

derived_info

DerivedInfo

Uniquement en sortie. Informations dérivées concernant l'entreprise.

suspended

bool

Uniquement en sortie. Indique si une entreprise est signalée comme étant rendue inaccessible au public par le service lorsque le contenu de son offre d'emploi paraît suspect ou abusif, ou qu'il semble contenir du spam.

DerivedInfo

Informations dérivées concernant l'entreprise.

Champs
headquarters_location

Location

Emplacement structuré du siège social de l'entreprise, résolu à partir du Company.headquarters_address si indiqué.

CompanySize

Énumération représentant la taille de l'entreprise.

Énumérations
COMPANY_SIZE_UNSPECIFIED Valeur par défaut si la taille n'est pas spécifiée.
MINI L'entreprise compte moins de 50 employés.
SMALL L'entreprise compte entre 50 et 99 employés.
SMEDIUM L'entreprise compte entre 100 et 499 employés.
MEDIUM L'entreprise compte entre 500 et 999 employés.
BIG L'entreprise compte entre 1 000 et 4 999 employés.
BIGGER L'entreprise compte entre 5 000 et 9 999 employés.
GIANT L'entreprise compte 10 000 employés ou plus.

CompensationFilter

Filtre par type et montant de rémunération.

Champs
type

FilterType

Obligatoire. Type de filtre.

units[]

CompensationUnit

Obligatoire. Spécifiez le paramètre base compensation entry's CompensationInfo.CompensationUnit souhaité.

range

CompensationRange

Plage de rémunération.

include_jobs_with_unspecified_compensation_range

bool

Si ce paramètre est défini sur "true", les emplois dont les champs de plage de rémunération n'ont pas été spécifiés sont inclus.

FilterType

Spécifie le type de filtrage.

Enums
FILTER_TYPE_UNSPECIFIED Type de filtre non spécifié. La valeur INVALID ne doit jamais être utilisée pour le titulaire du poste.
UNIT_ONLY

Filtrer par unité base compensation entry's. Une offre d'emploi est considérée comme pertinente uniquement si son champ "CompensationEntry" de base est renseigné et que l'unité de ce dernier correspond au champ units fourni. Renseignez un ou plusieurs éléments units.

Consultez CompensationInfo.CompensationEntry pour obtenir une définition de l'entrée de rémunération de base.

UNIT_AND_AMOUNT

Filtrer par unité base compensation entry's et par montant / plage. Une offre d'emploi est considérée comme pertinente uniquement si elle contient un élément "CompensationEntry" de base, et que l'unité associée à l'entrée de base correspond au champ CompensationUnit et au montant ou à la plage fournis.CompensationRange

Consultez CompensationInfo.CompensationEntry pour obtenir une définition de l'entrée de rémunération de base.

Définissez exactement un élément units et renseignez range.

ANNUALIZED_BASE_AMOUNT

Filtrer par montant de rémunération de base annualisée et par unité base compensation entry's. Renseignez range et zéro ou plusieurs units.

ANNUALIZED_TOTAL_AMOUNT

Filtrer par montant de rémunération totale annualisée et par unité base compensation entry's . Renseignez range et zéro ou plusieurs units.

CompensationInfo

Caractéristiques du poste à pourvoir liées à la rémunération.

Champs
entries[]

CompensationEntry

Informations relatives à la rémunération du poste à pourvoir.

Une seule entrée peut être de type CompensationInfo.CompensationType.BASE, appelé entrée de rémunération de base pour le poste.

annualized_base_compensation_range

CompensationRange

Uniquement en sortie. Plage de rémunération de base annualisée. Elle correspond au nombre CompensationEntry.amount de l'entrée de rémunération de base multiplié par CompensationEntry.expected_units_per_year.

Consultez CompensationEntry pour obtenir des explications sur l'annualisation de la rémunération.

annualized_total_compensation_range

CompensationRange

Uniquement en sortie. Plage de rémunération totale annualisée. Valeur : CompensationEntry.amount multipliée par CompensationEntry.expected_units_per_year pour toutes les entrées de rémunération.

Consultez CompensationEntry pour obtenir des explications sur l'annualisation de la rémunération.

CompensationEntry

Entrée de rémunération qui représente une composante de la rémunération, telle que le salaire de base, les primes ou un autre type de rémunération.

Rationalisation: une entrée de rémunération peut être annualisée si elle contient une valeur amount ou range valide. et son expected_units_per_year est défini ou peut être dérivé. Sa plage annualisée est déterminée comme suit : (amount ou range) multiplié par expected_units_per_year.

Champs
type

CompensationType

Type de rémunération.

La valeur par défaut est CompensationType.COMPENSATION_TYPE_UNSPECIFIED.

unit

CompensationUnit

Fréquence du montant indiqué.

La valeur par défaut est CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.

description

string

Description de la rémunération. Elle peut, par exemple, indiquer les conditions relatives aux actions, ou fournir davantage de contexte sur une prime estimée.

expected_units_per_year

DoubleValue

Nombre d'unités payées attendu par an. Si aucune valeur n'est spécifiée, lorsque Job.employment_types est défini sur FULLTIME, une valeur par défaut est déduite de la valeur unit. Valeurs par défaut : - HOURLY: 2080 - DAILY: 260 - WEEKLY: 52 - MONTHLY: 12 - ANNUAL: 1

Champ d'union compensation_amount. Montant de la rémunération. Il peut s'agir d'une valeur fixe ou d'une plage flottante. compensation_amount ne peut être qu'un des éléments suivants :
amount

Money

Montant de la rémunération.

range

CompensationRange

Plage de rémunération.

CompensationRange

Plage de rémunération.

Champs
max_compensation

Money

Montant maximal de la rémunération. Si ce champ est vide, sa valeur est définie sur une rémunération maximale, et le code de devise est défini pour correspondre à la valeur currency code de min_compensation.

min_compensation

Money

Montant minimal de la rémunération. Si ce champ n'est pas renseigné, la valeur est définie sur zéro et le code de devise est défini pour correspondre à l'élément currency code de max_compensation.

CompensationType

Type de rémunération.

Pour les rémunérations spécifiées en montants non monétaires, décrivez le système de rémunération dans le CompensationEntry.description.

Par exemple, le format de pourboire est décrit dans CompensationEntry.description (par exemple, "Attendez-vous à obtenir entre 15 et 20% de pourboire en fonction de la facture du client") et une estimation des pourboires fournis dans CompensationEntry.amount ou CompensationEntry.range (10 $ par heure).

Par exemple, les actions sont décrites dans CompensationEntry.description (par exemple, "1 % à 2% d'actions acquises sur quatre ans, un an de plus") et leur valeur estimée en CompensationEntry.amount ou CompensationEntry.range. Si aucune valeur estimée n'est possible, les unités sont CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED, puis précisées dans le champ CompensationEntry.description.

Enums
COMPENSATION_TYPE_UNSPECIFIED Valeur par défaut.
BASE Rémunération de base : désigne le montant fixe versé à un employé par un employeur en contrepartie du travail effectué. La rémunération de base n'inclut pas les avantages, les primes ou toute autre rémunération potentielle versée par un employeur.
BONUS Primes.
SIGNING_BONUS Prime à la signature du contrat.
EQUITY Actions.
PROFIT_SHARING Intéressement.
COMMISSIONS Commission.
TIPS Pourboires.
OTHER_COMPENSATION_TYPE Autres types de rémunération.

CompensationUnit

Fréquence de rémunération.

Enums
COMPENSATION_UNIT_UNSPECIFIED Valeur par défaut.
HOURLY Par heure.
DAILY Par jour.
WEEKLY Par semaine.
MONTHLY Par mois.
YEARLY Par an.
ONE_TIME Au forfait.
OTHER_COMPENSATION_UNIT Autres unités de rémunération.

CompleteQueryRequest

Paramètres de saisie semi-automatique.

Champs
parent

string

Obligatoire. Nom de ressource du locataire dans lequel l'achèvement est effectué.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé (par exemple, "projects/foo").

query

string

Obligatoire. Requête permettant de générer des suggestions.

Le nombre maximal de caractères autorisés est de 255.

language_codes[]

string

Liste des langues de la requête. Ce champ utilise les codes de langue BCP-47, tels que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page Tags for Identifying Languages (Balises d'identification de langues).

Le nombre maximal de caractères autorisés est de 255.

page_size

int32

Obligatoire. Nombre de résultats.

La taille de page maximale autorisée est de 10.

company

string

Si ce champ est fourni, limite la recherche à l'entreprise spécifiée.

Ce format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/foo/tenants/bar/companies/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé (par exemple, "projects/foo").

scope

CompletionScope

Champ d'application de la recherche. La valeur par défaut est CompletionScope.PUBLIC.

type

CompletionType

Type de recherche. La valeur par défaut est CompletionType.COMBINED.

CompletionScope

Énumération spécifiant le champ d'application de la recherche.

Enums
COMPLETION_SCOPE_UNSPECIFIED Valeur par défaut.
TENANT Les suggestions sont basées uniquement sur les données fournies par le client.
PUBLIC Les suggestions sont basées sur toutes les données concernant les offres d'emploi visibles par le client.

CompletionType

Énumération spécifiant le mode de saisie semi-automatique.

Enums
COMPLETION_TYPE_UNSPECIFIED Valeur par défaut.
JOB_TITLE

suggérer des titres de poste pour la saisie semi-automatique ;

Pour le type CompletionType.JOB_TITLE, seuls les postes à pourvoir ayant le même language_codes sont renvoyés.

COMPANY_NAME

Suggérer des noms d'entreprises pour la saisie semi-automatique des offres d'emploi.

Pour le type CompletionType.COMPANY_NAME, seules les entreprises ayant des postes à pourvoir avec le même language_codes sont renvoyées.

COMBINED

Suggérez des titres de poste et des noms d'entreprises pour la saisie semi-automatique des offres d'emploi.

Pour le type CompletionType.COMBINED, seuls les postes à pourvoir avec le même language_codes ou les entreprises ayant des postes à pourvoir avec le même language_codes sont renvoyés.

CompleteQueryResponse

Réponse de la requête en saisie semi-automatique.

Champs
completion_results[]

CompletionResult

Résultats des offres d'emploi/entreprises pertinentes.

metadata

ResponseMetadata

Informations supplémentaires sur l'appel de l'API, telles que l'ID de suivi de la requête.

CompletionResult

Ressource qui représente les résultats de recherche.

Champs
suggestion

string

Suggestion pour la requête.

type

CompletionType

Type de recherche.

image_uri

string

URI de l'image de l'entreprise pour COMPANY_NAME.

CreateClientEventRequest

Demande d'événement de rapport.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel l'événement est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé, par exemple "projects/foo".

client_event

ClientEvent

Obligatoire. Événements émis lorsque l'utilisateur final interagit avec l'application du client qui exploite Cloud Talent Solution.

CreateCompanyRequest

Requête avec la méthode CreateCompany.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel l'entreprise est créée.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé, par exemple "projects/foo".

company

Company

Obligatoire. Entreprise à créer.

CreateJobRequest

Requête de création d'une offre d'emploi.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel le job est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

job

Job

Obligatoire. Offre d'emploi à créer.

CreateTenantRequest

Requête de la méthode CreateTenant.

Champs
parent

string

Obligatoire. Nom de ressource du projet sous lequel le locataire est créé.

Ce paramètre est au format suivant : "projects/{project_id}". Par exemple, "projects/foo".

tenant

Tenant

Obligatoire. Locataire à créer.

CustomAttribute

Attributs personnalisés pouvant être filtrés ou non.

Champs
string_values[]

string

Vous ne devez spécifier qu'une seule des options string_values ou long_values.

Ce champ permet d'effectuer une recherche par correspondance de chaîne (CASE_SENSITIVE_MATCH ou CASE_INSENSITIVE_MATCH). Pour les string_value filtrables, un nombre total maximal de 200 valeurs est autorisé, chaque string_value ayant une taille en octets qui ne dépasse pas 500 octets. Pour les string_values non filtrables, la taille totale maximale en octets des string_values non filtrables est de 50 Ko.

Une chaîne vide n'est pas autorisée.

long_values[]

int64

Vous ne devez spécifier qu'une seule des options string_values ou long_values.

Ce champ permet d'effectuer une recherche par plage numérique. (EQ, GT, GE, LE, LT) sur les long_value filtrables.

Actuellement, 1 long_values maximum est accepté.

filterable

bool

Si l'option filterable est définie sur "true", les valeurs du champ personnalisé peuvent être utilisées pour les filtres d'attributs personnalisés JobQuery.custom_attribute_filter. Si la valeur est "false", ces valeurs ne peuvent pas être utilisées pour les filtres d'attributs personnalisés.

La valeur par défaut est "false".

keyword_searchable

bool

Si l'option keyword_searchable est définie sur "true", les mots clés des champs personnalisés peuvent faire l'objet d'une recherche par correspondance. Si la valeur est "false", les valeurs ne peuvent pas faire l'objet d'une recherche par correspondance de mot clé.

La valeur par défaut est "false".

DegreeType

Niveau d'enseignement défini dans la Classification Internationale Type de l'Éducation (CITE).

Enums
DEGREE_TYPE_UNSPECIFIED Valeur par défaut. Aucun enseignement, ou éducation de la petite enfance. Correspond au niveau 0 de la CITE. Exemple : école maternelle.
PRIMARY_EDUCATION Enseignement primaire correspondant généralement au premier cycle de l'enseignement obligatoire. Niveau 1 de la CITE. Exemple : école primaire.
LOWER_SECONDARY_EDUCATION Premier cycle de l'enseignement secondaire, complétant l'enseignement primaire. Le programme est généralement davantage axé sur les matières. Niveau 2 de la CITE. Exemple : collège.
UPPER_SECONDARY_EDUCATION Deuxième cycle de l'enseignement secondaire. Préparation à l'enseignement supérieur et/ou acquisition de compétences pertinentes pour exercer un emploi. Programmes offrant généralement un plus vaste choix d'options et de filières. Niveau 3 de la CITE. Exemple : lycée.
ADULT_REMEDIAL_EDUCATION Enseignement post-secondaire non supérieur. Programmes offrant des expériences d'apprentissage, complétant l'enseignement secondaire et préparant à l'entrée sur le marché du travail et/ou à l'enseignement supérieur. Le contenu est plus large que celui de l'enseignement secondaire, mais pas aussi complexe que celui de l'enseignement supérieur. Niveau 4 de la CITE.
ASSOCIATES_OR_EQUIVALENT Enseignement supérieur de cycle court. Programmes courts de premier cycle de l'enseignement supérieur. Ils sont généralement axés sur la pratique, sont propres à une profession et préparent à l'entrée sur le marché du travail. Ces programmes peuvent également ouvrir la voie à d'autres programmes de l'enseignement supérieur. Niveau 5 de la CITE.
BACHELORS_OR_EQUIVALENT Niveau licence ou équivalent. Programmes conçus pour enseigner des connaissances, aptitudes et compétences académiques et/ou professionnelles intermédiaires conduisant à un premier diplôme universitaire ou à une certification équivalente. Niveau 6 de la CITE.
MASTERS_OR_EQUIVALENT Niveau master ou équivalent. Programmes conçus pour enseigner des connaissances, aptitudes et compétences académiques et/ou professionnelles avancées conduisant à un deuxième diplôme universitaire ou à une certification équivalente. Niveau 7 de la CITE.
DOCTORAL_OR_EQUIVALENT Niveau doctorat ou équivalent. Programmes principalement destinés à l'obtention d'une certification de chercheur hautement qualifié. Ils s'achèvent généralement par la remise et la soutenance d'une thèse d'une qualité suffisante pour en permettre la publication et basée sur des recherches originales. Niveau 8 de la CITE.

DeleteCompanyRequest

Requête pour supprimer une entreprise.

Champs
name

string

Obligatoire. Nom de ressource de l'entreprise à supprimer.

Ce format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/foo/tenants/bar/companies/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé (par exemple, "projects/foo/companies/bar").

DeleteJobRequest

Requête de suppression d'une offre d'emploi.

Champs
name

string

Obligatoire. Nom de ressource de l'offre d'emploi à supprimer.

Le format est le suivant : "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Par exemple, "projects/foo/tenants/bar/jobs/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/jobs/bar".

DeleteTenantRequest

Requête de suppression d'un locataire.

Champs
name

string

Obligatoire. Nom de ressource du locataire à supprimer.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenants/bar".

DeviceInfo

Informations sur l'appareil recueillies auprès du chercheur d'emploi, du candidat ou de toute autre entité effectuant la recherche d'emploi. En fournissant ces informations, vous améliorez la qualité des résultats de recherche sur tous les appareils.

Champs
device_type

DeviceType

Type d'appareil.

id

string

ID spécifique à l'appareil. Il doit s'agir d'un identifiant unique qui permet de distinguer l'appareil des autres.

DeviceType

Énumération décrivant le portail d'accès à l'API et les mécanismes d'exposition.

Enums
DEVICE_TYPE_UNSPECIFIED Type d'appareil non spécifié.
WEB Navigateur Web de bureau, tel que Chrome, Firefox, Safari ou Internet Explorer.
MOBILE_WEB Navigateur Web d'appareil mobile, comme un téléphone ou une tablette avec un navigateur Chrome.
ANDROID Application native pour appareils Android.
IOS Application native pour appareils iOS.
BOT Bot, par opposition à un appareil utilisé par des êtres humains, comme un robot d'exploration.
OTHER Autres types d'appareils.

EmploymentType

Énumération représentant le type d'emploi d'une offre.

Enums
EMPLOYMENT_TYPE_UNSPECIFIED Valeur par défaut si le type de poste n'est pas spécifié.
FULL_TIME Le poste à pourvoir nécessite de travailler un nombre d'heures qui représente un temps plein. En général, ce nombre est de 40 heures ou plus par semaine.
PART_TIME Le poste à pourvoir implique de travailler moins d'heures que pour un temps plein, en général moins de 40 heures par semaine.
CONTRACTOR Le poste à pourvoir est proposé via un statut de contractuel, et non un statut de salarié.
CONTRACT_TO_HIRE Le poste proposé correspond à un statut de contractuel, étant entendu qu'à la fin du contrat, ce dernier débouchera sur un poste à temps plein. Les offres d'emploi de ce type sont également renvoyées par une recherche d'offres d'emploi EmploymentType.CONTRACTOR.
TEMPORARY Le poste à pourvoir est proposé dans le cadre d'un contrat de travail temporaire, généralement pour un engagement à court terme.
INTERN Le poste à pourvoir est un contrat à durée déterminée ou un stage destiné aux étudiants ou aux nouveaux chercheurs d'emploi, afin d'obtenir une formation pratique. Ces contrats sont souvent proposés pour la saison estivale.
VOLUNTEER Il s'agit d'une offre de bénévolat, pour laquelle aucune rémunération n'est attendue pour les services rendus.
PER_DIEM Le poste à pourvoir implique que l'employé travaille suivant les besoins de l'entreprise, selon un emploi du temps flexible.
FLY_IN_FLY_OUT Le poste à pourvoir implique de recruter des personnes dans des régions éloignées et de les envoyer temporairement sur le lieu de travail, plutôt que de faire déménager définitivement les employés et leurs familles.
OTHER_EMPLOYMENT_TYPE Le poste à pourvoir ne correspond à aucun des autres types répertoriés.

GetCompanyRequest

Requête pour récupérer une entreprise par son nom.

Champs
name

string

Obligatoire. Nom de ressource de l'entreprise à récupérer.

Ce format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/api-test-project/tenants/foo/companies/bar".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé (par exemple, "projects/api-test-project/companies/bar").

GetJobRequest

Requête pour obtenir une offre d'emploi.

Champs
name

string

Obligatoire. Nom de ressource de l'offre d'emploi à récupérer.

Le format est le suivant : "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Par exemple, "projects/foo/tenants/bar/jobs/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/jobs/bar".

GetTenantRequest

Requête d'obtention d'un locataire par son nom.

Champs
name

string

Obligatoire. Nom de ressource du locataire à récupérer.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenants/bar".

HistogramQuery

Requête d'histogramme.

Champs
histogram_query

string

Une expression spécifie une requête d'histogramme par rapport à des ressources correspondantes (telles que des offres d'emploi ou des profils) pour les recherches.

Consultez SearchJobsRequest.histogram_queries et SearchProfilesRequest.histogram_queries pour en savoir plus sur la syntaxe.

HistogramQueryResult

Résultat de l'histogramme correspondant aux HistogramQuery spécifiés dans les recherches.

Champs
histogram_query

string

Expression d'histogramme demandée.

histogram

map<string, int64>

Mappage des valeurs de l'attribut associé à des valeurs distinctes au nombre d'entrées correspondantes dotées de la valeur concernée.

Le format de la clé est le suivant:

  • (pour un histogramme de chaîne) des valeurs de chaîne stockées dans le champ.
  • (pour un bucket numérique nommé) spécifié dans la fonction bucket(). Par exemple, pour bucket(0, MAX, "non-negative"), la clé sera non-negative.
  • (pour un bucket numérique anonyme) formatée en tant que <low>-<high>, par exemple, 0-1000, MIN-0 et 0-MAX.

HtmlSanitization

Option de nettoyage du contenu HTML sur les champs saisis par l'utilisateur, par exemple la description du poste. Lorsque cette option est définie, l'utilisateur peut déterminer s'il souhaite activer ou non le nettoyage de ces champs, ainsi que le mode de nettoyage.

Énumérations
HTML_SANITIZATION_UNSPECIFIED Valeur par défaut.
HTML_SANITIZATION_DISABLED Désactive le nettoyage sur les saisies au format HTML.
SIMPLE_FORMATTING_ONLY Nettoie les saisies au format HTML et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces).

Job

Une ressource "Job" (offre d'emploi) représente une ou plusieurs offres d'emploi, également appelées "missions" ou "demandes de recrutement". Une offre d'emploi appartient à une entité (Company) qui est l'entité responsable du recrutement pour ce poste.

Champs
name

string

Obligatoire pendant la mise à jour de l'offre d'emploi.

Nom de ressource de l'offre d'emploi. Il est généré par le service lors de la création d'une offre d'emploi.

Le format est le suivant : "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Par exemple, "projects/foo/tenants/bar/jobs/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/jobs/bar".

Étant donné que sa valeur est unique, il est préférable d'utiliser ce champ dans les requêtes d'emploi et les appels d'API plutôt que requisition_id.

company

string

Obligatoire. Nom de ressource de l'entreprise proposant l'offre d'emploi.

Le format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/foo/tenants/bar/companies/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/companies/bar".

requisition_id

string

Obligatoire. ID de l'ouverture de poste (également appelé ID de publication) attribué par le client pour identifier une offre d'emploi. Ce champ est destiné à être utilisé par les clients pour leur identification et le suivi des offres d'emploi. Vous n'êtes pas autorisé à créer un job s'il existe une autre tâche avec les mêmes valeurs company, language_code et requisition_id.

Le nombre maximal de caractères autorisés est de 255.

title

string

Obligatoire. Intitulé du poste, tel que "Ingénieur logiciel".

Le nombre maximal de caractères autorisés est de 500.

description

string

Obligatoire. Description de l'offre d'emploi, qui comprend généralement une description de l'entreprise et des informations connexes structurées en plusieurs paragraphes. Des champs distincts sont fournis dans l'objet de tâche pour responsibilities, qualifications et d'autres caractéristiques. Il est recommandé d'utiliser ces champs de description distincts.

Ce champ accepte et nettoie les saisies au format HTML, et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces).

Le nombre maximal de caractères autorisés est de 100 000.

addresses[]

string

Fortement recommandé pour une expérience de service optimale.

Le ou les lieux où l'employeur cherche à recruter pour l'offre concernée.

Si vous indiquez l'adresse complète du lieu de recrutement, l'API fournit de meilleurs résultats, notamment pour les recherches d'emploi effectuées par temps de trajet domicile-travail.

Un nombre maximal de 50 lieux est autorisé, pour permettre une meilleure performance de recherche. Si une mission comporte plusieurs emplacements, il est conseillé de la diviser en plusieurs tâches avec des valeurs requisition_id uniques (par exemple, "ReqA" devient "ReqA-1", "ReqA-2", etc.), car plusieurs jobs avec les mêmes company, language_code et requisition_id ne sont pas autorisés. Si la valeur requisition_id d'origine doit être conservée, un champ personnalisé doit être utilisé pour le stockage. Nous vous conseillons également de regrouper les lieux proches les uns des autres dans une même offre d'emploi pour une meilleure expérience de recherche.

Le nombre maximal de caractères autorisés est de 500.

application_info

ApplicationInfo

Informations relatives à la candidature.

job_benefits[]

JobBenefit

Avantages proposés avec le poste.

compensation_info

CompensationInfo

Informations sur la rémunération du poste à pourvoir (autrement dit, "taux de rémunération"), c'est-à-dire la rémunération qui sera versée à l'employé.

custom_attributes

map<string, CustomAttribute>

Carte des champs destinée à contenir les attributs personnalisés filtrables et non filtrables de l'offre d'emploi qui ne sont pas couverts par les champs structurés fournis.

Les clés de la carte sont des chaînes de 64 octets au maximum et doivent correspondre au modèle suivant : [a-zA-Z][a-zA-Z0-9_]*. Par exemple, key0LikeThis ou KEY_1_LIKE_THIS.

100 clés filtrables et 100 clés non filtrables sont compatibles au maximum. Pour les string_values filtrables, toutes les clés avec un maximum de 200 valeurs sont autorisées, chaque chaîne ne contenant pas plus de 255 caractères. Pour les string_values non filtrables, la taille totale maximale de string_values pour l'ensemble des clés est de 50 Ko.

degree_types[]

DegreeType

Niveau de formation souhaité pour le poste à pourvoir, tel que "licence" ou "master".

department

string

Service ou domaine d'activités de l'entreprise où le poste est proposé.

Le nombre maximal de caractères autorisés est de 255.

employment_types[]

EmploymentType

Type(s) d'emploi d'un emploi (par exemple, full time ou part time).

incentives

string

Description des primes, commissions et autres incitations en matière de rémunération associées au poste à pourvoir, à l'exclusion du salaire.

Le nombre maximal de caractères autorisés est de 10 000.

language_code

string

Langue de l'offre. Ce champ ne concerne pas les exigences liées à la maîtrise d'une langue pour le poste à pourvoir.

Les codes de langue doivent être au format BCP-47, tels que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page Tags for Identifying Languages (Balises d'identification de langues).

Si ce champ n'est pas spécifié et que Job.description est présent, le code de langue détecté basé sur Job.description est attribué. Sinon, la valeur par défaut est "en_US".

job_level

JobLevel

Niveau d'expérience associé au poste à pourvoir, tel que "Premier échelon".

promotion_value

int32

Valeur promotionnelle de l'offre d'emploi, telle que déterminée par le client. La valeur détermine l'ordre de tri des offres renvoyées lors de la recherche à l'aide de l'appel de recherche d'emploi à la une, les valeurs promotionnelles les plus élevées étant renvoyées en premier et les liens étant résolus par le tri par pertinence. Seules les offres d'emploi dont la valeur du champ "promotionValue" est supérieure à 0 sont renvoyées dans le mode de recherche FEATURED_JOB_SEARCH.

La valeur par défaut est de 0. Les valeurs négatives sont considérées comme égales à 0.

qualifications

string

Description des qualifications requises pour remplir les fonctions liées au poste à pourvoir. Nous vous recommandons d'utiliser ce champ à la place du champ description, plus général.

Ce champ accepte et nettoie les saisies au format HTML, et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces).

Le nombre maximal de caractères autorisés est de 10 000.

responsibilities

string

Description des responsabilités liées au poste à pourvoir. Nous vous recommandons d'utiliser ce champ à la place du champ description, plus général.

Ce champ accepte et nettoie les saisies au format HTML, et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces).

Le nombre maximal de caractères autorisés est de 10 000.

posting_region

PostingRegion

PostingRegion du poste (par exemple, l'État ou le pays) où le poste à pourvoir est proposé. Si ce champ est défini, LocationFilter dans une requête de recherche dans la région du poste permet de trouver cette offre d'emploi si aucune correspondance de lieu exacte n'est spécifiée. Si ce champ est défini sur PostingRegion.NATION ou PostingRegion.ADMINISTRATIVE_AREA, nous vous recommandons vivement de définir le job Job.addresses sur le même lieu.

visibility
(deprecated)

Visibility

Obsolète. Seul le propriétaire peut voir cette offre d'emploi.

Visibilité de l'offre d'emploi.

Si aucune valeur n'est spécifiée, la valeur par défaut est Visibility.ACCOUNT_ONLY.

job_start_time

Timestamp

Horodatage de début du poste à pourvoir dans le fuseau horaire UTC. Généralement, ce champ est utilisé pour les contrats. Les horodatages non valides sont ignorés.

job_end_time

Timestamp

Horodatage de fin du poste à pourvoir. Généralement, ce champ est utilisé pour les contrats. Les horodatages non valides sont ignorés.

posting_publish_time

Timestamp

Horodatage de la dernière publication de l'offre d'emploi. La valeur par défaut est le moment auquel la requête arrive sur le serveur. Les horodatages non valides sont ignorés.

posting_expire_time

Timestamp

Fortement recommandé pour une expérience de service optimale.

Horodatage de l'expiration de l'offre d'emploi. Après cet horodatage, elle est marquée comme expirée et n'apparaît plus dans les résultats de recherche. L'offre d'emploi expirée ne peut pas être listée par l'API ListJobs, mais elle peut être récupérée avec l'API GetJob, mise à jour avec l'API UpdateJob ou supprimée avec l'API DeleteJob. Vous pouvez mettre à jour et rouvrir une offre d'emploi expirée à l'aide d'un code temporel d'expiration ultérieur. La mise à jour d'un job arrivé à expiration échoue s'il existe un autre job ouvert avec les mêmes valeurs company, language_code et requisition_id.

Les offres d'emploi expirées sont conservées dans notre système pendant 90 jours. Toutefois, le nombre total d'offres d'emploi expirées ne peut pas dépasser trois fois le nombre maximal d'offres d'emploi à pourvoir au cours des sept derniers jours. Si ce seuil est dépassé, les offres d'emploi expirées sont nettoyées dans l'ordre de la date d'expiration la plus proche. Les offres d'emploi expirées ne sont plus accessibles après leur suppression.

Les horodatages non valides sont ignorés et traités comme des dates d'expiration non fournies.

Si le code temporel est antérieur à la requête instantanée, l'offre d'emploi est considérée comme expirée dès sa création. Impossible de mettre à jour ce type de tâche. De plus, lors de la création d'une tâche dont le code temporel est passé, posting_publish_time doit être défini avant posting_expire_time. L'objectif de cette fonctionnalité est d'autoriser d'autres objets, tels que Application, à faire référence à une offre d'emploi qui n'existait pas dans le système avant son expiration. Si vous souhaitez modifier un job arrivé à expiration lors de sa création, supprimez-le et créez-en un autre.

Si cette valeur n'est pas spécifiée au moment de la création de l'offre d'emploi ou est non valide, cette dernière expire 30 jours après sa création. Par exemple, si l'offre d'emploi a été créée le 01/01/2017 à 13h00 UTC sans date d'expiration, elle expirera après le 31/01/2017 à 13h00 UTC.

Si cette valeur n'est pas fournie lors de la mise à jour de l'offre d'emploi, elle dépend des masques de champ définis par UpdateJobRequest.update_mask. Si les masques de champ incluent job_end_time ou s'ils sont vides (ce qui signifie que tous les champs sont mis à jour), l'offre d'emploi expire 30 jours après sa dernière mise à jour. Sinon, la date d'expiration n'est pas mise à jour.

posting_create_time

Timestamp

Uniquement en sortie. Horodatage de création de l'offre d'emploi.

posting_update_time

Timestamp

Uniquement en sortie. Horodatage de dernière mise à jour de l'offre d'emploi.

company_display_name

string

Uniquement en sortie. Nom de l'entreprise proposant le poste.

derived_info

DerivedInfo

Uniquement en sortie. Informations dérivées concernant l'offre d'emploi.

processing_options

ProcessingOptions

Options pour le traitement de l'offre d'emploi.

ApplicationInfo

Informations liées à une candidature à un poste.

Champs
emails[]

string

Renseignez ce champ pour indiquer les adresses e-mail à utiliser pour envoyer des CV ou des candidatures.

Le nombre maximal de caractères autorisés est de 255 par entrée.

instruction

string

Renseignez ce champ pour fournir des instructions que chaque candidat doit suivre pour postuler, telles que "Envoyez votre candidature à…".

Ce champ accepte et nettoie les saisies au format HTML, et autorise l'utilisation de balises de mise en forme (gras, italique, listes numérotées ou listes à puces).

Le nombre maximal de caractères autorisés est de 3 000.

uris[]

string

Renseignez ce champ d'URI pour rediriger les candidats vers un site Web, avec un lien vers un formulaire de candidature en ligne, par exemple.

Le nombre maximal de caractères autorisés est de 2 000 par entrée.

DerivedInfo

Informations dérivées concernant l'offre d'emploi.

Champs
locations[]

Location

Lieux structurés du poste à pourvoir, résolus à partir du Job.addresses.

locations correspondent exactement à Job.addresses, dans le même ordre.

job_categories[]

JobCategory

Catégories d'emplois dérivées de Job.title et Job.description.

ProcessingOptions

Options pour le traitement de l'offre d'emploi.

Champs
disable_street_address_resolution

bool

Si la valeur est true, le service ne tente pas de résoudre une adresse plus précise pour l'offre d'emploi.

html_sanitization

HtmlSanitization

Option de nettoyage du contenu HTML relatif à l'offre d'emploi. Le nettoyage s'applique aux champs suivants :

  • description
  • applicationInfo.instruction
  • incentives
  • qualifications
  • responsibilities

Les balises HTML de ces champs peuvent être supprimées si l'option de nettoyage est activée.

La valeur par défaut est HtmlSanitization.SIMPLE_FORMATTING_ONLY.

JobBenefit

Énumération représentant les avantages offerts à l'employé pour le poste à pourvoir.

Enums
JOB_BENEFIT_UNSPECIFIED Valeur par défaut si le type n'est pas spécifié.
CHILD_CARE Le poste à pourvoir comprend l'accès à des programmes d'aide à la garde d'enfants, comme une crèche.
DENTAL Le poste à pourvoir comprend des services dentaires couverts par une assurance de soins dentaires.
DOMESTIC_PARTNER Le poste à pourvoir propose des avantages spécifiques destinés aux conjoints des employés.
FLEXIBLE_HOURS Le poste à pourvoir permet d'avoir un emploi du temps avec des horaires flexibles.
MEDICAL Le poste à pourvoir comprend des services de santé couverts par une mutuelle.
LIFE_INSURANCE Le poste à pourvoir comprend une assurance-vie fournie par l'employeur ou disponible à l'achat pour l'employé.
PARENTAL_LEAVE Le poste à pourvoir permet de prendre un congé parental pour s'occuper d'un nouveau-né.
RETIREMENT_PLAN Le poste à pourvoir comprend un régime de retraite proposé par l'entreprise ou disponible à l'achat pour l'employé.
SICK_DAYS Le poste à pourvoir permet de prendre des congés maladie payés.
VACATION Le poste à pourvoir comprend des congés payés.
VISION Le poste à pourvoir comprend des services d'optique et d'ophtalmologie couverts par une assurance spécialisée dans ce domaine.

JobCategory

Énumération représentant la classification ou le principal objectif d'un poste spécifique. Cette valeur est différente du "secteur" associé à un poste, qui est lié à la classification de l'entreprise proposant l'offre d'emploi.

Énumérations
JOB_CATEGORY_UNSPECIFIED Valeur par défaut si la catégorie n'est pas spécifiée.
ACCOUNTING_AND_FINANCE Emploi dans le domaine de la comptabilité et de la finance (par exemple, comptable).
ADMINISTRATIVE_AND_OFFICE Emploi administratif et de bureau (par exemple, assistant administratif).
ADVERTISING_AND_MARKETING Emploi dans le domaine de la publicité et du marketing, (par exemple, responsable marketing).
ANIMAL_CARE Emploi dans le domaine du soin animalier (par exemple, vétérinaire).
ART_FASHION_AND_DESIGN Emploi dans le domaine artistique, de la mode ou du design (par exemple, designer).
BUSINESS_OPERATIONS Emploi dans le domaine commercial (par exemple, responsable des opérations commerciales).
CLEANING_AND_FACILITIES Emploi dans le domaine du nettoyage et des installations (par exemple, personnel de surveillance).
COMPUTER_AND_IT Emploi dans le domaine de l'informatique (par exemple, administrateur système).
CONSTRUCTION Emploi dans le domaine de la construction (par exemple, ouvrier général).
CUSTOMER_SERVICE Emploi dans le domaine du service à la clientèle (par exemple, caissier).
EDUCATION Emploi dans le domaine de l'éducation (par exemple, enseignant).
ENTERTAINMENT_AND_TRAVEL Emploi dans le domaine du tourisme et des voyages (par exemple, hôtesse de l'air).
FARMING_AND_OUTDOORS Emploi agricole ou de plein air (par exemple, garde-forestier).
HEALTHCARE Emploi dans le domaine de la santé (par exemple, infirmier).
HUMAN_RESOURCES Emploi dans le domaine des ressources humaines (par exemple, directeur des ressources humaines).
INSTALLATION_MAINTENANCE_AND_REPAIR Emploi dans le domaine de l'installation, de la maintenance ou de la réparation (par exemple, électricien).
LEGAL Emploi dans le domaine juridique (par exemple, clerc de notaire).
MANAGEMENT Emploi dans le domaine de la gestion, souvent associé à une autre catégorie (par exemple, directeur de magasin).
MANUFACTURING_AND_WAREHOUSE Emploi dans le domaine de la fabrication et de l'usinage (par exemple, technicien d'assemblage).
MEDIA_COMMUNICATIONS_AND_WRITING Emploi dans le domaine des médias, de la communication ou de l'édition (par exemple, responsable des relations médias).
OIL_GAS_AND_MINING Emploi dans le domaine pétrolier, gazier ou minier (par exemple, foreur offshore).
PERSONAL_CARE_AND_SERVICES Emploi dans le domaine des services à la personne (par exemple, coiffeur).
PROTECTIVE_SERVICES Emploi dans le domaine des services de protection (par exemple, vigile).
REAL_ESTATE Emploi dans le domaine de l'immobilier (par exemple, agent immobilier).
RESTAURANT_AND_HOSPITALITY Emploi dans le domaine de l'hôtellerie et de la restauration (par exemple, serveur).
SALES_AND_RETAIL Emploi dans le domaine de la vente (par exemple, commercial).
SCIENCE_AND_ENGINEERING Emploi dans le domaine des sciences et de l'ingénierie (par exemple, technicien de laboratoire).
SOCIAL_SERVICES_AND_NON_PROFIT Emploi dans le domaine du social ou emploi à but non lucratif (par exemple, assistant social).
SPORTS_FITNESS_AND_RECREATION Emploi dans le domaine du sport, de la remise en forme ou des loisirs (par exemple, coach personnel).
TRANSPORTATION_AND_LOGISTICS Emploi dans le domaine des transports et de la logistique (par exemple, chauffeur routier).

JobEvent

Événement émis lorsqu'un demandeur d'emploi interagit avec l'application qui met en œuvre Cloud Talent Solution.

Champs
type

JobEventType

Obligatoire. Type d'événement (voir JobEventType).

jobs[]

string

Obligatoire. Le job name(s) associé à cet événement. Par exemple, s'il s'agit d'un événement impression, ce champ contient les identifiants de toutes les offres d'emploi présentées au demandeur d'emploi. S'il s'agit d'un événement view, ce champ contient l'identifiant du poste consulté.

Le format est "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". Par exemple, "projects/foo/tenants/bar/jobs/baz".

profile

string

Le profile name associé à cet événement client.

Ce format est le suivant : "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". Par exemple, "projects/foo/tenants/bar/profiles/baz".

JobEventType

Énumération d'un événement attribué au comportement de l'utilisateur final, par exemple un demandeur d'emploi.

Enums
JOB_EVENT_TYPE_UNSPECIFIED L'événement n'est pas spécifié par d'autres valeurs fournies.
IMPRESSION Le demandeur d'emploi ou une autre entité utilisant le service a reçu une offre d'emploi apparaissant sur son écran, par exemple dans une liste de résultats de recherche au format condensé ou sous forme d'extraits. Cet événement est généralement associé à la consultation d'une liste d'offres d'emploi sur une seule page, de la part du demandeur d'emploi.
VIEW Le demandeur d'emploi ou une autre entité utilisant le service a consulté les informations d'une offre d'emploi, y compris la description détaillée. Cet événement ne s'applique pas à l'affichage d'un extrait de poste apparaissant dans les résultats de recherche (l'affichage d'un extrait est associé à un impression).
VIEW_REDIRECT Le demandeur d'emploi ou une autre entité utilisant le service a voulu consulter une offre d'emploi et a été redirigé vers un autre site Web.
APPLICATION_START Le demandeur d'emploi ou une autre entité utilisant le service a lancé le processus ou a manifesté l'intention de postuler à une offre.
APPLICATION_FINISH Le demandeur d'emploi ou une autre entité utilisant le service a envoyé une candidature en réponse à une offre.
APPLICATION_QUICK_SUBMISSION Le demandeur d'emploi ou une autre entité utilisant le service a envoyé, en un seul clic, une candidature en réponse à une offre, sans renseigner d'informations. Si un demandeur d'emploi procède ainsi, n'envoyez que cet événement au service. N'envoyez pas non plus d'événements JobEventType.APPLICATION_START ou JobEventType.APPLICATION_FINISH.
APPLICATION_REDIRECT Le demandeur d'emploi ou une autre entité utilisant le service a voulu postuler à une offre et a été redirigé vers un autre site Web pour compléter sa candidature.
APPLICATION_COMPANY_SUBMIT Cet événement est à utiliser lorsqu'une entreprise soumet une candidature au nom d'un demandeur d'emploi. Il est destiné aux agences de recrutement qui placent des candidats.
BOOKMARK Le demandeur d'emploi ou une autre entité utilisant le service a manifesté son intérêt pour une offre d'emploi en l'ajoutant à ses favoris ou en la sauvegardant.
NOTIFICATION Le demandeur d'emploi ou une autre entité utilisant le service a reçu une notification, telle qu'une alerte par e-mail ou une notification sur son appareil, contenant une ou plusieurs offres générées par le service.
HIRED Le demandeur d'emploi ou une autre entité utilisant le service a été embauché par l'entité qui recrute (l'employeur). N'envoyez cet événement que si le demandeur d'emploi a été embauché suite à une candidature envoyée après une recherche effectuée via le service Cloud Talent Solution.
SENT_CV Un recruteur ou une agence de recrutement a soumis une candidature au nom du candidat après avoir interagi avec le service pour identifier une offre d'emploi appropriée.
INTERVIEW_GRANTED L'entité de recrutement (l'employeur) a accordé un premier entretien à l'entité interagissant avec le service (par exemple, le demandeur d'emploi). Cet événement ne doit être envoyé que si le demandeur d'emploi a reçu une demande d'entretien dans le cadre d'une candidature résultant d'une recherche effectuée via le service Cloud Talent Solution ou d'une recommandation transmise par ce service.

JobLevel

Énumération représentant le niveau d'expérience nécessaire pour occuper le poste à pourvoir.

Enums
JOB_LEVEL_UNSPECIFIED Valeur par défaut si le niveau n'est pas spécifié.
ENTRY_LEVEL Personnes nouvelles sur le marché du travail, ayant en général moins de deux ans d'expérience sur un poste similaire. Inclut les stagiaires.
EXPERIENCED Personnes expérimentées, ayant en général deux ans ou plus d'expérience sur un poste similaire.
MANAGER Cadres débutants ou intermédiaires, responsables de la gestion d'une équipe d'employés.
DIRECTOR Cadres supérieurs, responsables de la gestion d'équipes de cadres.
EXECUTIVE Cadres de direction et échelons supérieurs, y compris les postes de hauts responsables.

JobOperationResult

Le résultat des API JobService.BatchCreateJobs ou JobService.BatchUpdateJobs. Elle est utilisée pour remplacer google.longrunning.Operation.response en cas de réussite.

Champs
job_results[]

JobResult

Liste des résultats de mutation de job à la suite d'une opération de mutation en série. Elle peut changer jusqu'à ce que l'état de l'opération soit TERMINÉ, ÉCHEC ou ANNULÉ.

JobResult

Résultat de mutation d'une tâche.

Champs
job

Job

Ici, Job ne contient que des informations de base, y compris name, company, language_code et requisition_id. Utilisez la méthode getJob pour récupérer des informations détaillées sur le job créé/mis à jour.

status

Status

État de la tâche traitée. Ce champ est renseigné si le traitement de job échoue.

JobQuery

Requête obligatoire pour effectuer une recherche.

Champs
query

string

Chaîne de requête qui correspond aux champs relatifs à l'intitulé du poste, à sa description et au lieu de travail.

Le nombre maximal de caractères autorisés est de 255.

query_language_code

string

Code de langue de query. Exemple : "fr-FR". Ce champ permet de mieux interpréter la requête.

Si aucune valeur n'est spécifiée, le code de langue de la requête est automatiquement détecté, ce qui peut ne pas être précis.

Le code de langue doit être au format BCP-47, par exemple "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page Tags for Identifying Languages (Balises d'identification de langues).

companies[]

string

Ce filtre spécifie les entreprises parmi lesquelles rechercher des offres d'emploi.

Si aucune valeur n'est spécifiée, la recherche s'applique aux offres d'emploi de toutes les entreprises.

Si plusieurs valeurs sont spécifiées, la recherche s'applique aux offres d'emploi des entreprises indiquées.

Le format est le suivant : "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". Par exemple, "projects/foo/tenants/bar/companies/baz".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé. Par exemple, "projects/foo/companies/bar".

La recherche peut comporter jusqu'à 20 filtres d'entreprise.

location_filters[]

LocationFilter

Le filtre de lieu spécifie les régions géographiques des offres d'emploi à rechercher. Pour en savoir plus, consultez LocationFilter.

Si aucune valeur de lieu n'est spécifiée, les offres d'emploi correspondant aux autres critères de recherche sont récupérées, quelle que soit la zone géographique concernée.

Si plusieurs valeurs sont spécifiées, les offres d'emploi sont extraites de l'un des lieux spécifiés. Si différentes valeurs sont spécifiées pour le paramètre LocationFilter.distance_in_miles, la distance maximale fournie est utilisée pour tous les lieux.

La recherche peut comporter jusqu'à cinq filtres de lieu.

job_categories[]

JobCategory

Le filtre de catégorie spécifie les catégories des offres d'emploi à rechercher. Pour en savoir plus, consultez JobCategory.

Si aucune valeur n'est spécifiée, la recherche s'applique à l'ensemble des offres d'emploi, peu importe leur catégorie.

Si plusieurs valeurs sont spécifiées, la recherche s'applique aux offres d'emploi des catégories indiquées.

commute_filter

CommuteFilter

Permet de filtrer les offres d'emploi selon le temps de trajet domicile-travail avec différents modes de transport (par exemple, en voiture ou en transports en commun).

Remarque: Cela ne fonctionne que lorsque vous spécifiez un CommuteMethod. Dans ce cas, location_filters est ignoré.

Le tri par temps de trajet domicile-travail n'est actuellement pas possible.

company_display_names[]

string

Ce filtre spécifie le Company.display_name exact de l'entreprise parmi les offres d'emploi à rechercher.

Si aucune valeur n'est spécifiée, les offres d'emploi figurant dans les résultats de recherche sont associées à n'importe quelle entreprise.

Si plusieurs valeurs sont spécifiées, les offres d'emploi figurant dans les résultats de recherche sont associées aux entreprises indiquées.

La recherche peut comporter jusqu'à 20 filtres de nom d'entreprise à afficher.

compensation_filter

CompensationFilter

Ce filtre de recherche ne s'applique qu'à Job.compensation_info. Par exemple, si le filtre est défini sur "Travail horaire avec rémunération horaire > 15 $", seules les offres d'emploi répondant à ces critères sont recherchées. Si aucun filtre n'est défini, tous les postes à pourvoir sont recherchés.

custom_attribute_filter

string

Ce filtre spécifie une syntaxe structurée à mettre en correspondance avec l'élément Job.custom_attributes marqué comme filterable.

La syntaxe de cette expression est un sous-ensemble de la syntaxe SQL.

Les opérateurs compatibles sont =, !=, <, <=, > et >=. À gauche de l'opérateur se trouve une clé de champ personnalisé, et à droite un nombre ou une chaîne entre guillemets. Vous devez échapper les barres obliques inverses (\) et les guillemets (").

Les fonctions compatibles sont LOWER([field_name]) pour effectuer une mise en correspondance non sensible à la casse et EMPTY([field_name]) pour filtrer en fonction de l'existence d'une clé.

Les expressions booléennes (AND/OR/NOT) sont acceptées jusqu'à trois niveaux d'imbrication (par exemple, "((A AND B AND C) OR NOT D) AND E") et peuvent comporter jusqu'à 100 comparaisons/fonctions. L'expression doit comporter moins de 6 000 octets.

Exemple de requête: (LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND driving_years > 10

disable_spell_check

bool

Cet indicateur contrôle la fonctionnalité de correcteur orthographique. Si la valeur est "false", le service tente de corriger une requête mal orthographiée. Par exemple, "ingénieu" est remplacé par "ingénieur".

La valeur par défaut est "false", ce qui implique une vérification orthographique.

employment_types[]

EmploymentType

Le filtre de type de poste spécifie le type de poste des offres d'emploi à rechercher, par exemple EmploymentType.FULL_TIME.

Si aucune valeur n'est spécifiée, les offres d'emploi figurant dans les résultats de recherche incluent n'importe quel type de poste.

Si plusieurs valeurs sont spécifiées, les offres d'emploi figurant dans les résultats de recherche incluent les types de postes indiqués.

language_codes[]

string

Ce filtre spécifie les paramètres régionaux des offres d'emploi à rechercher, par exemple "en-US".

Si aucune valeur n'est spécifiée, les résultats de la recherche peuvent contenir des offres d'emploi répondant à tous les paramètres régionaux.

Les codes de langue doivent être au format BCP-47, tels que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page Tags for Identifying Languages (Balises d'identification de langues).

La recherche peut comporter jusqu'à 10 filtres de code de langue.

publish_time_range

TimestampRange

La recherche s'applique aux offres d'emploi publiées dans une plage spécifiée par ce filtre.

excluded_jobs[]

string

Ce filtre spécifie une liste de noms d'offres d'emploi à exclure lors de la recherche.

Un maximum de 400 noms de jobs exclus est autorisé.

JobView

Énumération spécifiant les attributs d'offre d'emploi renvoyés dans les champs MatchingJob.job ou ListJobsResponse.jobs.

Enums
JOB_VIEW_UNSPECIFIED Valeur par défaut.
JOB_VIEW_ID_ONLY Vue de la tâche par ID uniquement, avec les attributs suivants: Job.name, Job.requisition_id, Job.language_code.
JOB_VIEW_MINIMAL Vue minimale de la tâche, avec les attributs suivants: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.language_code.
JOB_VIEW_SMALL Petit aperçu de l'offre d'emploi, avec les attributs suivants dans les résultats de recherche: Job.name, Job.requisition_id, Job.title, Job.company, Job.DerivedInfo.locations, Job.visibility, Job.language_code, Job.description.
JOB_VIEW_FULL Tous les attributs disponibles sont inclus dans les résultats de recherche.

ListCompaniesRequest

Permet de répertorier les entreprises pour lesquelles le client à un accès ACL.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel l'entreprise est créée.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar".

Si l'ID du locataire n'est pas spécifié, le locataire par défaut est utilisé (par exemple, "projects/foo").

page_token

string

Indicateur de départ à partir duquel renvoyer les résultats.

page_size

int32

Nombre maximal d'entreprises à renvoyer. Cette valeur ne doit pas dépasser 100. La valeur par défaut est 100 si un nombre non positif est indiqué.

require_open_jobs

bool

Défini sur "true" si les entreprises recherchées doivent avoir des postes à pourvoir.

Valeur par défaut : "false".

Si la valeur est "true", page_size des entreprises sont récupérées au maximum, parmi lesquelles seules celles proposant des postes à pourvoir sont renvoyées.

ListCompaniesResponse

Objet de la réponse à une requête destinée à répertorier les offres d'emploi.

Champs
companies[]

Company

Entreprises pour le client actuel.

next_page_token

string

Jeton permettant de récupérer la page de résultats suivante.

metadata

ResponseMetadata

Informations supplémentaires sur l'appel de l'API, telles que l'ID de suivi de la requête.

ListJobsRequest

Requête permettant de répertorier les offres d'emploi.

Champs
parent

string

Obligatoire. Nom de ressource du locataire sous lequel le job est créé.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

filter

string

Obligatoire. La chaîne de filtres indique les offres d'emploi à répertorier.

Opérateur accepté : =, AND

Les champs permettant le filtrage sont les suivants :

  • companyName (obligatoire)
  • requisitionId
  • status Valeurs disponibles: OPEN, EXPIRED, ALL. La valeur par défaut est OPEN si aucune valeur n'est spécifiée.

Exemple de requête :

  • companyName = "projects/foo/tenants/bar/companies/baz"
  • companyName = "projects/foo/tenants/bar/companies/baz" AND requisitionId = "req-1"
  • companyName = "projects/foo/tenants/bar/companies/baz" AND status = "EXPIRED"
page_token

string

Point de départ d'un résultat de requête.

page_size

int32

Nombre maximal d'offres d'emploi à renvoyer par page de résultats.

Si job_view est défini sur JobView.JOB_VIEW_ID_ONLY, la taille de page maximale autorisée est de 1 000. Sinon, elle est de 100.

La valeur par défaut est 100 si le champ est vide ou si un nombre inférieur à 1 est spécifié.

job_view

JobView

Attributs d'offre d'emploi souhaités renvoyés dans la réponse de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est JobView.JOB_VIEW_FULL.

ListJobsResponse

Réponse à une requête destinée à répertorier les offres d'emploi.

Champs
jobs[]

Job

Offres d'emploi d'une entreprise donnée.

Le nombre maximal d'éléments renvoyés est basé sur le champ limite fourni dans la requête.

next_page_token

string

Jeton permettant de récupérer la page de résultats suivante.

metadata

ResponseMetadata

Informations supplémentaires sur l'appel de l'API, telles que l'ID de suivi de la requête.

ListTenantsRequest

Permet de lister les locataires pour lesquels le client dispose d'une visibilité dans la LCA.

Champs
parent

string

Obligatoire. Nom de ressource du projet sous lequel le locataire est créé.

Ce paramètre est au format suivant : "projects/{project_id}". Par exemple, "projects/foo".

page_token

string

Indicateur de départ à partir duquel renvoyer les résultats.

page_size

int32

Nombre maximal de locataires à renvoyer (100 au maximum). La valeur par défaut est 100 si un nombre non positif est indiqué.

ListTenantsResponse

Objet de réponse Lister les locataires.

Champs
tenants[]

Tenant

Locataires pour le client actuel.

next_page_token

string

Jeton permettant de récupérer la page de résultats suivante.

metadata

ResponseMetadata

Informations supplémentaires sur l'appel de l'API, telles que l'ID de suivi de la requête.

Emplacement

Ressource représentant un lieu avec des informations géographiques complètes.

Champs
location_type

LocationType

Type de lieu, qui correspond au champ de lignes d'adresse de google.type.PostalAddress. Par exemple, "Centre-ville, Atlanta, Géorgie, États-Unis" est de type LocationType.NEIGHBORHOOD, tandis que "Kansas City, Kansas, États-Unis" est de type LocationType.LOCALITY.

postal_address

PostalAddress

Adresse postale du lieu contenant des informations lisibles, telles que des adresses de livraison et de paiement. Les services postaux peuvent effectuer une livraison à cette adresse, boîte postale ou autre.

lat_lng

LatLng

Objet représentant une paire latitude/longitude.

radius_miles

double

Rayon, en miles, du lieu de travail. Cette valeur est dérivée du cadre de délimitation du lieu dans lequel un cercle dont le rayon spécifié est centré à partir de google.type.LatLng couvre la zone associée au lieu de travail. Par exemple, "Mountain View, CA, USA" a actuellement un rayon de 6,17 miles.

LocationType

Énumération représentant le type de lieu.

Enums
LOCATION_TYPE_UNSPECIFIED Valeur par défaut si le type n'est pas spécifié.
COUNTRY Pays.
ADMINISTRATIVE_AREA État ou équivalent.
SUB_ADMINISTRATIVE_AREA Comté ou équivalent.
LOCALITY Ville ou équivalent.
POSTAL_CODE Code postal.
SUB_LOCALITY Sous-localité. Il s'agit d'une subdivision d'une localité, par exemple un arrondissement, une circonscription. Les sous-localités sont généralement reconnues par les autorités politiques locales. Par exemple, Manhattan et Brooklyn sont reconnues par la ville de New York comme des arrondissements et sont donc modélisées comme des sous-localités.
SUB_LOCALITY_1 Arrondissement ou équivalent.
SUB_LOCALITY_2 Arrondissement plus petit ou équivalent.
NEIGHBORHOOD Quartier.
STREET_ADDRESS Rue.

LocationFilter

Région géographique de la recherche.

Champs
address

string

Nom de l'adresse, tel que "Mountain View" ou "Région de la baie de San Francisco".

region_code

string

Code pays/région CLDR de l'adresse. Ce champ permet d'éviter toute ambiguïté sur le lieu recherché. Par exemple, "Liverpool" peut référer à "Liverpool, New York, États-Unis" ou à "Liverpool, Royaume-Uni".

Définissez ce champ pour orienter la résolution de la position géographique vers un pays ou un territoire spécifique. Si ce champ n'est pas défini, le comportement de l'application privilégie les États-Unis par défaut.

Pour en savoir plus, consultez la page https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse. Notez que ce filtre n'est pas applicable aux requêtes associées à la recherche de profils.

lat_lng

LatLng

Latitude et longitude du centre géographique à partir duquel effectuer la recherche. Ce champ est ignoré si address est fourni.

distance_in_miles

double

Le champ "distance_in_miles" est appliqué lorsque le lieu recherché est identifié comme étant une ville ou une zone plus petite. Ce champ est ignoré si le lieu recherché correspond à un État ou à une zone plus grande.

telecommute_preference

TelecommutePreference

Permet au client de renvoyer des offres d'emploi sans lieu défini, en particulier des offres de télétravail (le service considère le télétravail comme un lieu spécial). Job.posting_region indique si un emploi autorise le télétravail. Si ce champ est défini sur TelecommutePreference.TELECOMMUTE_ALLOWED, les postes à pourvoir en télétravail sont recherchés, et address et lat_lng sont ignorés. Si cette règle n'est pas configurée ou qu'elle est définie sur TelecommutePreference.TELECOMMUTE_EXCLUDED, les postes à pourvoir en télétravail ne font pas l'objet de la recherche.

Ce filtre peut être utilisé seul pour rechercher exclusivement des postes en télétravail. Il peut également être combiné à un autre filtre de lieu pour effectuer une recherche avec une combinaison de lieux, tels que "Mountain View" et "télétravail". Toutefois, lorsqu'ils sont utilisés en association avec d'autres filtres de lieux, les postes à pourvoir en télétravail ont tendance à être considérés comme étant moins pertinents que les autres résultats de recherche.

Ce champ n'est utilisé que pour les requêtes de recherche d'emploi.

negated

bool

Détermine si une négation est appliquée au filtre afin d'exclure les profils correspondant à celui-ci.

À l'heure actuelle, ce champ n'est disponible que dans la recherche de profils.

TelecommutePreference

Indiquez si vous souhaitez inclure les postes en télétravail.

Enums
TELECOMMUTE_PREFERENCE_UNSPECIFIED Valeur par défaut si la préférence concernant le télétravail n'est pas spécifiée.
TELECOMMUTE_EXCLUDED Exclut les postes à pouvoir en télétravail.
TELECOMMUTE_ALLOWED Inclut les postes à pourvoir en télétravail.

PostingRegion

Énumération représentant la région de l'offre d'emploi. Dans la plupart des cas, les offres d'emploi n'ont pas besoin d'inclure une région. Si une région est spécifiée, les postes à pourvoir peuvent faire l'objet de recherches dans la région concernée.

Enums
POSTING_REGION_UNSPECIFIED Si la région n'est pas spécifiée, la tâche n'est renvoyée que si elle correspond à LocationFilter.
ADMINISTRATIVE_AREA

En plus de la correspondance de lieu exacte, l'offre d'emploi est renvoyée lorsque LocationFilter dans la requête de recherche se trouve dans la même région administrative que l'offre d'emploi renvoyée. Par exemple, si une offre d'emploi au format ADMINISTRATIVE_AREA est publiée dans"Californie, États-Unis", elle est renvoyée si LocationFilter contient "Mountain View".

"Administrative_Area" (Zone administrative) fait référence à la plus haute subdivision administrative du pays concerné. Par exemple, un État américain, une région italienne, une nation du Royaume-Uni ou une préfecture japonaise.

NATION En plus de la correspondance de lieu exacte, l'offre d'emploi est renvoyée lorsque LocationFilter dans la requête de recherche se trouve dans le même pays que le poste en question. Par exemple, si une offre d'emploi NATION_WIDE est publiée dans"États-Unis", elle est renvoyée si LocationFilter indique "Mountain View".
TELECOMMUTE Le poste à pourvoir permet aux employés de travailler à distance (télétravail). Si des lieux sont indiqués avec cette valeur, le poste est considéré comme associé à un lieu, mais le télétravail est autorisé.

RequestMetadata

Méta-informations relatives au chercheur d'emploi ou à l'entité effectuant la recherche d'emploi. Ces informations servent à améliorer les performances du service.

Champs
domain

string

Obligatoire si la règle allow_missing_ids n'est pas définie ou si elle est définie sur false.

Champ d'application défini par le client ou source de l'appel de service, qui correspond généralement au domaine sur lequel le service a été mis en œuvre et est en cours d'exécution.

Par exemple, si le service est exécuté par le client Foo, Inc., sur le site d'offre d'emploi www.foo.com et sur le site de recrutement www.bar.com, ce champ contient respectivement les valeurs "foo.com" et "bar.com".

Notez que ce champ doit être correctement défini sur un domaine unique pour que le modèle puisse être amélioré pour un site client spécifique.

Le nombre maximal de caractères autorisés est de 255.

session_id

string

Obligatoire si la règle allow_missing_ids n'est pas définie ou si elle est définie sur false.

Chaîne d'identification de session unique. Une session est définie comme la durée de l'interaction d'un utilisateur final avec le service sur une période donnée. Masquez ce champ pour des raisons de confidentialité avant de le fournir au service.

Notez que ce champ doit être correctement défini sur un ID de session unique pour que le modèle puisse être amélioré pour un site client spécifique.

Le nombre maximal de caractères autorisés est de 255.

user_id

string

Obligatoire si la règle allow_missing_ids n'est pas définie ou si elle est définie sur false.

Chaîne d'identification d'utilisateur unique, telle que déterminée par le client. Pour optimiser la qualité de la recherche, assurez-vous que cette valeur est unique au niveau du client. Masquez ce champ pour des raisons de confidentialité avant de le fournir au service.

Notez que ce champ doit être correctement défini sur un ID utilisateur unique pour que le modèle puisse être amélioré pour un site client spécifique.

Le nombre maximal de caractères autorisés est de 255.

allow_missing_ids

bool

Défini uniquement lorsque domain, session_id ou user_id n'est pas disponible pour une raison inconnue. Pour une expérience de service optimale, nous vous recommandons vivement de ne pas définir ce champ et de fournir des valeurs domain, session_id et user_id exactes.

device_info

DeviceInfo

Type d'appareil utilisé par le demandeur d'emploi au moment de l'appel du service.

ResponseMetadata

Informations supplémentaires renvoyées au client, telles que des informations de débogage.

Champs
request_id

string

ID unique associé à cet appel. Cet ID est enregistré à des fins de suivi.

SearchJobsRequest

Corps de la requête de l'appel SearchJobs.

Champs
parent

string

Obligatoire. Nom de ressource du locataire dans lequel effectuer la recherche.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenant/bar". Si l'ID du locataire n'est pas spécifié, un locataire par défaut est créé. Par exemple, "projects/foo".

search_mode

SearchMode

Mode de recherche.

La valeur par défaut est SearchMode.JOB_SEARCH.

request_metadata

RequestMetadata

Obligatoire. Méta-informations recueillies auprès du chercheur d'emploi, qui permettent d'améliorer la qualité de recherche du service. Les identifiants (tels que user_id) sont fournis par les utilisateurs et doivent être uniques et cohérents.

job_query

JobQuery

Requête permettant de rechercher des offres d'emploi, incluant des mots clés, des filtres de lieux, etc.

enable_broadening

bool

Détermine si la recherche doit être élargie lorsqu'elle produit peu de résultats. Les recherches élargies ajoutent leurs résultats à la fin de la liste des résultats obtenue initialement.

Valeur par défaut : "false".

require_precise_result_size
(deprecated)

bool

Ce champ est obsolète.

histogram_queries[]

HistogramQuery

Une expression spécifie une requête d'histogramme par rapport à des offres d'emploi correspondantes.

La syntaxe d'expression est un appel de fonction d'agrégation doté d'attributs d'histogramme et d'autres options.

Les appels de fonction d'agrégation disponibles sont les suivants: * count(string_histogram_facet): comptabilise le nombre d'entités correspondantes pour chaque valeur d'attribut distincte. * count(numeric_histogram_facet, list of buckets): comptabilise le nombre d'entités correspondantes dans chaque bucket.

Types de données :

  • Attribut d'histogramme : noms d'attribut au format [a-zA-Z][a-zA-Z0-9_]+.
  • Chaîne : chaîne du type "toute chaîne avec une barre oblique inverse comme caractère d'échappement pour les guillemets (")".
  • Nombre : nombre entier et nombre à virgule flottante tel que 10, -1 ou -0,01.
  • Liste : liste d'éléments avec une virgule (,) en guise de séparateur, placée entre crochets. Par exemple, [1, 2, 3] ou ["un", "deux", "trois"].

Constantes intégrées :

  • MIN (nombre minimal semblable à Double.MIN_VALUE Java)
  • MAX (nombre maximal semblable à Double.MAX_VALUE Java)

Fonctions intégrées :

  • La fonction de bucket intégrée bucket(start, end[, label]) crée un bucket avec une plage [début, fin). Notez que la fin est exclusive. Par exemple, bucket(1, MAX, "positive number") ou bucket(1, 10).

Attributs d'histogramme des offres d'emploi :

  • company_display_name: histogramme par Job.company_display_name.
  • employment_type: histogramme par Job.employment_types. Par exemple, "FULL_TIME" ou "PART_TIME".
  • company_size: histogramme par CompanySize. Par exemple, "PETITE", "MOYENNE" ou "BIG".
  • publish_time_in_month: histogramme par mois de Job.posting_publish_time. Doit indiquer la liste des buckets numériques dans la spécification.
  • publish_time_in_year: histogramme par Job.posting_publish_time, en années. Doit indiquer la liste des buckets numériques dans la spécification.
  • degrés_types: histogramme par Job.degree_types. Par exemple, "Licence" ou "Master".
  • job_level: histogramme par valeur Job.job_level, par exemple, "Entry Level".
  • country : histogramme par code de pays des offres d'emploi. Par exemple, "US" ou "FR".
  • admin1: histogramme par code admin1 des offres d'emploi, qui est un espace réservé global faisant référence à l'État, à la province ou au terme particulier utilisé par un pays pour définir la structure géographique en dessous du niveau du pays (par exemple, "CA" ou "IL").
  • city : histogramme par combinaison du nom de la ville et du code admin1. Par exemple, "Mountain View, CA" ou "New York, NY".
  • admin1_country: histogramme par combinaison du code admin1 et du pays. Par exemple, "CA, US", "IL, US".
  • city_Coordinate: histogramme par coordonnées GPS du centre-ville (latitude et longitude), par exemple, 37.4038522,-122.0987765. Étant donné que les coordonnées d'un centre-ville peuvent changer, les clients peuvent avoir besoin de les actualiser régulièrement.
  • locale: histogramme par valeur de Job.language_code. Par exemple, "en-US" ou "fr-FR".
  • language: histogramme par sous-tag de langue de Job.language_code. Par exemple, "en" ou "fr".
  • catégorie: histogramme par JobCategory. Par exemple, "COMPUTER_AND_IT" ou "HEALTHCARE".
  • base_compensation_unit: histogramme par CompensationInfo.CompensationUnit du salaire de base. Par exemple, "WEEKLY" ou "Monthly".
  • base_compensation : histogramme par salaire de base. Vous devez spécifier la liste des buckets numériques selon lesquels regrouper les résultats.
  • annualized_base_compensation : histogramme par salaire de base annualisé. Doit spécifier la liste des buckets numériques utilisés pour regrouper les résultats.
  • annualized_total_compensation : histogramme par salaire total annualisé. Doit spécifier la liste des buckets numériques utilisés pour regrouper les résultats.
  • string_custom_attribute: histogramme par chaîne Job.custom_attributes. Les valeurs sont accessibles via des notations entre crochets, telles que string_custom_attribute["key1"].
  • number_custom_attribute: histogramme par valeur numérique de Job.custom_attributes. Les valeurs sont accessibles via des notations entre crochets, telles quenumeric_custom_attribute["key1"]. Vous devez spécifier la liste des buckets numériques selon lesquels regrouper les résultats.

Exemples d'expressions :

  • count(admin1)
  • count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])
  • count(string_custom_attribute["some-string-custom-attribute"])
  • count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
job_view

JobView

Attributs d'offre d'emploi souhaités renvoyés dans la réponse de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est JobView.JOB_VIEW_SMALL.

offset

int32

Valeur entière qui spécifie le décalage de la recherche, c'est-à-dire le point de départ choisi parmi les offres d'emploi jugées pertinentes par l'API dans les résultats de recherche. Ce champ n'est pris en compte que si page_token n'est pas défini.

La valeur maximale autorisée est de 5 000. Dans le cas contraire, une erreur est renvoyée.

Par exemple, la valeur 0 renvoie les résultats à partir de l'offre la plus pertinente. La valeur 10, quant à elle, renvoie les résultats à partir de la 11e offre d'emploi pertinente. Ce champ peut être utilisé pour la pagination (par exemple, pageSize = 10 et offset = 10 signifie que la requête renvoie les résultats de la deuxième page).

page_size

int32

Limite du nombre d'offres d'emploi renvoyées dans les résultats de recherche. Augmenter cette valeur au-dessus de 10 (la valeur par défaut) peut prolonger le temps de réponse de la recherche. Cette valeur peut être comprise entre 1 et 100.

page_token

string

Jeton spécifiant le décalage actuel dans les résultats de recherche. Consultez SearchJobsResponse.next_page_token pour découvrir comment obtenir l'ensemble de résultats de requête suivant.

order_by

string

Critères déterminant le mode de tri des résultats de recherche. La valeur par défaut est "relevance desc".

Les options suivantes sont acceptées :

  • "relevance desc": par pertinence décroissante, comme déterminé par les algorithmes de l'API. Le seuil de pertinence des résultats de la requête n'est disponible qu'avec cet ordre.
  • "posting_publish_time desc": par Job.posting_publish_time dans l'ordre décroissant.
  • "posting_update_time desc": par Job.posting_update_time dans l'ordre décroissant.
  • "title": par Job.title dans l'ordre croissant.
  • "title desc": par Job.title dans l'ordre décroissant.
  • "annualized_base_compensation": par valeur CompensationInfo.annualized_base_compensation_range du job dans l'ordre croissant. Les offres d'emploi dont la rémunération de base annualisée n'est pas spécifiée sont placées à la fin des résultats de recherche.
  • "annualized_base_compensation desc": par CompensationInfo.annualized_base_compensation_range du job dans l'ordre décroissant. Les offres d'emploi dont la rémunération de base annualisée n'est pas spécifiée sont placées à la fin des résultats de recherche.
  • "annualized_total_compensation": par valeur CompensationInfo.annualized_total_compensation_range du job dans l'ordre croissant. Les offres d'emploi dont la rémunération de base annualisée n'est pas spécifiée sont placées à la fin des résultats de recherche.
  • "annualized_total_compensation desc": par CompensationInfo.annualized_total_compensation_range du job dans l'ordre décroissant. Les offres d'emploi dont la rémunération de base annualisée n'est pas spécifiée sont placées à la fin des résultats de recherche.
  • "custom_ranking desc": par le score de pertinence ajusté à la valeur SearchJobsRequest.CustomRankingInfo.ranking_expression avec un facteur de pondération attribué par SearchJobsRequest.CustomRankingInfo.importance_level dans l'ordre décroissant.
  • Tri par lieu : utilisez la syntaxe spéciale pour classer les missions en fonction de la distance.
    "distance_from('Hawaii')" : triez les missions selon la distance depuis Hawaï.
    "distance_from(19.89, 155.5)": triez par distance à partir d'une coordonnée.
    "distance_from('Hawaii'), distance_from('Puerto Rico')": commandez selon plusieurs établissements. Consultez les détails ci-dessous.
    "distance_from('Hawaii'), distance_from(19.89, 155.5)": commandez selon plusieurs établissements. Consultez les détails ci-dessous.
    La chaîne ne doit pas comporter plus de 256 caractères. Lorsque plusieurs centres de distance sont fournis, un emploi proche de n'importe lequel des centres de distance obtiendra un rang élevé. Lorsqu'un poste est réparti sur plusieurs sites, le lieu le plus proche de l'un des centres de distance sera utilisé. Les offres d'emploi qui ne sont associées à aucun lieu sont classées en bas. La distance est calculée avec une précision de 11,3 mètres. La stratégie de diversification s'applique toujours, sauf si elle est explicitement désactivée dans diversification_level.
diversification_level

DiversificationLevel

Détermine si les offres d'emploi très similaires sont renvoyées côte à côte dans les résultats de recherche. Les offres d'emploi sont identifiées comme très similaires en fonction de leur intitulé, de leur catégorie et du lieu. Les résultats très similaires sont regroupés pour ne proposer au demandeur d'emploi qu'une offre représentative en haut des résultats. Les autres postes à pourvoir sont affichés plus bas dans les résultats.

Si aucune valeur n'est spécifiée, la valeur par défaut est DiversificationLevel.SIMPLE.

custom_ranking_info

CustomRankingInfo

Définit la façon dont les documents d'offre d'emploi sont classés par rapport au score de pertinence existant (déterminé par un algorithme d'API).

disable_keyword_match

bool

Détermine s'il faut désactiver le mot clé exact pour Job.title, Job.description, Job.company_display_name, Job.addresses et Job.qualifications. Lorsque cette fonctionnalité est désactivée, la correspondance d'un mot clé renvoie des offres d'emploi qui ne correspondent pas aux filtres de catégorie fournis lorsque des mots clés concordent. Par exemple, pour la requête "chef de projet", un résultat est renvoyé même si l'offre d'emploi est intitulée "développeur logiciel". Cela ne correspond pas à l'ontologie de "chef de projet", mais l'offre contient l'expression "chef de projet" dans sa description.

Pour des requêtes telles que "cloud" qui ne contiennent pas d'ontologie propre à l'intitulé ou au lieu, les offres d'emploi avec des correspondances du mot clé "cloud" sont renvoyées, quelle que soit la valeur de cet indicateur.

Utilisez Company.keyword_searchable_job_custom_attributes si des valeurs de chaîne d'attribut/champ personnalisé spécifiques à l'entreprise et à l'échelle mondiale sont nécessaires. L'activation de la correspondance de mots clés améliore le rappel des requêtes de recherche ultérieures.

Valeur par défaut : "false".

CustomRankingInfo

Informations de classement personnalisées pour SearchJobsRequest.

Champs
importance_level

ImportanceLevel

Obligatoire. Détermine l'importance que le score de CustomRankingInfo.ranking_expression doit donner au classement final de l'offre d'emploi.

Une erreur est renvoyée si ce champ n'est pas spécifié.

ranking_expression

string

Obligatoire. Définit la façon dont les documents d'offre d'emploi sont classés par rapport au score de pertinence existant (déterminé par un algorithme d'API). Pour déterminer le classement final de l'offre d'emploi, nous utilisons une combinaison de l'expression de classement et du score de pertinence.

La syntaxe de cette expression est un sous-ensemble de la syntaxe Google SQL.

Les opérateurs +, -, * et / sont acceptés. Les côtés gauche et droit de l'opérateur sont soit une clé numérique Job.custom_attributes, un nombre entier/double ou une expression pouvant être évaluée en tant que nombre.

Il est possible d'utiliser des parenthèses pour ajuster la priorité de calcul. L'expression doit comporter moins de 100 caractères.

L'expression est considérée comme non valide pour une tâche si elle fait référence à des attributs personnalisés qui ne sont pas renseignés dans la tâche ou si elle génère une division par zéro. Si une expression n'est pas valide pour une tâche, celle-ci est rétrogradée à la fin des résultats.

Exemple d'expression de classement : (année + 25) * 0,25 - (fraîcheur / 0,5)

ImportanceLevel

Niveau d'importance pour CustomRankingInfo.ranking_expression.

Enums
IMPORTANCE_LEVEL_UNSPECIFIED Valeur par défaut si le niveau d'importance n'est pas spécifié.
NONE L'expression de classement fournie n'influe aucunement sur le classement final de l'offre d'emploi, qui est déterminé par le score de pertinence existant (calculé par un algorithme d'API).
LOW L'expression de classement fournie n'influe que faiblement sur le classement final de l'offre d'emploi par rapport au score de pertinence existant (calculé par un algorithme d'API).
MILD L'expression de classement fournie influe légèrement sur le classement final de l'offre d'emploi par rapport au score de pertinence existant (calculé par un algorithme d'API).
MEDIUM L'expression de classement fournie influe moyennement sur le classement final de l'offre d'emploi par rapport au score de pertinence existant (calculé par un algorithme d'API).
HIGH L'expression de classement fournie influe fortement sur le classement final de l'offre d'emploi par rapport au score de pertinence existant (calculé par un algorithme d'API).
EXTREME L'expression de classement fournie influe considérablement sur le classement final de l'offre d'emploi et détermine celui-ci. Le score de pertinence existant (calculé par un algorithme d'API) est ignoré.

DiversificationLevel

Détermine si les offres d'emploi très similaires sont renvoyées côte à côte dans les résultats de recherche. Les offres d'emploi sont identifiées comme très similaires en fonction de leur intitulé, de leur catégorie et du lieu. Les résultats très similaires sont regroupés pour ne proposer au demandeur d'emploi qu'une offre représentative en haut des résultats. Les autres postes à pourvoir sont affichés plus bas dans les résultats.

Énumérations
DIVERSIFICATION_LEVEL_UNSPECIFIED Le niveau de diversification n'est pas spécifié.
DISABLED Désactive la diversification. La position des offres d'emploi se retrouvant normalement à la dernière page n'est pas modifiée. Cela peut entraîner l'apparition d'offres d'emploi consécutives très similaires dans les résultats de recherche.
SIMPLE Comportement de diversification par défaut. La liste des résultats est classée de sorte que les résultats très similaires se retrouvent à la fin de la dernière page des résultats de recherche. Si vous utilisez "pageToken" pour parcourir l'ensemble de résultats, la latence peut être inférieure, mais nous ne pouvons pas garantir que tous les résultats seront renvoyés. Si vous utilisez le décalage de page, la latence peut être plus élevée, mais tous les résultats sont renvoyés.

SearchMode

Énumération représentée par une chaîne spécifiant le mode de recherche d'offres d'emploi. Le service fonctionne différemment selon les modes de service.

Énumérations
SEARCH_MODE_UNSPECIFIED Aucune méthode de recherche n'est spécifiée. Le comportement de recherche par défaut est identique à celui de JOB_SEARCH.

SearchJobsResponse

Réponse de la méthode SearchJob.

Champs
matching_jobs[]

MatchingJob

Entités d'offres d'emploi correspondant au SearchJobsRequest spécifié.

histogram_query_results[]

HistogramQueryResult

Résultats de l'histogramme correspondant au SearchJobsRequest.histogram_queries spécifié.

next_page_token

string

Jeton qui indique la position de départ de la page suivante des résultats. Ce champ est vide s'il n'y a pas de résultats sur la prochaine page.

location_filters[]

Location

Filtres de lieu appliqués par le service à la requête spécifiée. Si l'un des filtres est basé sur la latitude et la longitude, Location.location_type est défini sur Location.LocationType.LOCATION_TYPE_UNSPECIFIED.

estimated_total_size

int32

Estimation du nombre d'offres d'emploi correspondant à la requête spécifiée.

La précision de ce nombre n'est pas garantie. Pour obtenir des résultats précis, consultez SearchJobsResponse.total_size.

total_size

int32

Nombre de résultats précis avec une limite de 100 000.

metadata

ResponseMetadata

Informations supplémentaires sur l'appel de l'API, telles que l'ID de suivi de la requête.

broadened_query_jobs_count

int32

Si l'élargissement de la requête est activé, des résultats supplémentaires correspondant à des critères élargis peuvent être ajoutés. La valeur de ce champ indique combien d'offres d'emploi renvoyées peuvent provenir de la requête élargie. Ces résultats sont toujours placés à la fin de la liste des offres d'emploi. Notez que, si ce champ a une valeur de 0 ou qu'il n'est pas spécifié, toutes les offres d'emploi renvoyées proviennent de la requête d'origine (sans élargissement). Si ce champ contient une valeur supérieure à 0, les requêtes ultérieures adjoindront à la liste des résultats initiaux tous les résultats élargis définis.

spell_correction

SpellingCorrection

Résultat de la vérification orthographique, et correction.

CommuteInfo

Informations liés au trajet domicile-travail pour l'offre d'emploi.

Champs
job_location

Location

Lieu utilisé comme destination dans le calcul du temps de trajet domicile-travail.

travel_duration

Duration

Nombre de secondes nécessaires pour se rendre au lieu de travail à partir du lieu défini par la requête. Une valeur de 0 seconde indique que le lieu de travail n'est pas accessible dans l'intervalle de temps demandé, mais a été renvoyé dans le cadre d'une recherche élargie.

MatchingJob

Offre d'emploi dont les métadonnées correspondent à SearchJobsResponse.

Champs
job

Job

Ressource de la tâche correspondant au SearchJobsRequest spécifié.

job_summary

string

Résumé de l'offre d'emploi contenant des informations essentielles et affichée sur la page de la liste des résultats de recherche.

job_title_snippet

string

Extraits de texte du champ Job.title correspondant le plus aux mots clés saisis lors de la requête de recherche, le cas échéant. Les mots clés correspondants sont entourés de balises HTML afin d'apparaître en gras.

search_text_snippet

string

Extraits de texte du champ Job.description et de champs similaires qui correspondent le mieux aux mots clés saisis lors de la requête de recherche, le cas échéant. Toutes les balises HTML des champs d'origine sont supprimées lors du renvoi dans ce champ. Dans le même temps, les mots clés correspondant à la requête sont entourés de balises HTML afin d'apparaître en gras.

commute_info

CommuteInfo

Informations sur le trajet domicile-travail, générées en fonction des données CommuteFilter spécifiées.

SpellingCorrection

Résultat de vérification orthographique.

Champs
corrected

bool

Indique si la requête a été corrigée par le vérificateur orthographique.

corrected_text

string

Résultat de la correction, composé de la chaîne de mots clés corrigés.

corrected_html

string

Résultat corrigé, qui inclut des balises HTML pour mettre en évidence les corrections. Les mots corrigés sont signalés par les balises HTML "...".

Par exemple, pour un utilisateur qui émet une requête d'entrée "ingénieu logiciel", le premier mot "ingénieu" est incorrect. Ici, le bon terme serait "ingénieur". Lorsque la correction orthographique est activée, cette valeur est définie sur "ingénieur logiciel".

Locataire

Une ressource de locataire représente un locataire dans le service. Un locataire est un groupe ou une entité qui partage un accès commun à des ressources telles que des profils avec des droits spécifiques. Le Client peut créer plusieurs locataires afin d'isoler les données de différents groupes.

Champs
name

string

Obligatoire pendant la mise à jour du locataire.

Nom de ressource d'un locataire. Il est généré par le service lors de la création d'un locataire.

Le format est "projects/{project_id}/tenants/{tenant_id}". Par exemple, "projects/foo/tenants/bar".

external_id

string

Obligatoire. Identifiant du locataire côté client, permettant d'identifier le locataire de manière unique.

Le nombre maximal de caractères autorisés est de 255.

usage_type

DataUsageType

Indique si les données appartenant à ce locataire peuvent être utilisées pour améliorer le produit pour d'autres locataires.

Si la règle n'est pas configurée, le comportement par défaut est DataUsageType.ISOLATED.

keyword_searchable_profile_custom_attributes[]

string

Liste de clés de Profile.custom_attributes filtrables, dont les string_values correspondantes sont utilisées dans les recherches par mots clés. Les profils avec string_values sous ces clés de champ spécifiées sont renvoyés si l'une des valeurs correspond au mot clé de recherche. Les valeurs des champs personnalisés comportant des parenthèses, des crochets et des symboles spéciaux ne peuvent pas faire l'objet d'une recherche en l'état et doivent être entourées de guillemets.

DataUsageType

Énumération représentant la manière dont les données utilisateur appartenant au locataire sont utilisées.

Enums
DATA_USAGE_TYPE_UNSPECIFIED Valeur par défaut.
AGGREGATED Les données appartenant à ce locataire sont utilisées pour améliorer la qualité de la recherche/recommandation entre les locataires.
ISOLATED Les données appartenant à ce locataire sont utilisées pour améliorer la qualité de la recherche/recommandation pour ce locataire uniquement.

TimestampRange

Message représentant une période de temps entre deux horodatages.

Champs
start_time

Timestamp

Début de la période (inclus).

end_time

Timestamp

Fin de la période (exclue).

UpdateCompanyRequest

Requête de mise à jour d'une entreprise spécifiée.

Champs
company

Company

Obligatoire. Ressource de l'entreprise devant remplacer la ressource actuelle dans le système.

update_mask

FieldMask

Fortement recommandé pour une expérience de service optimale.

Si update_mask est fourni, seuls les champs spécifiés dans company sont mis à jour. Sinon, tous les champs sont mis à jour.

Masque de champ permettant de spécifier les champs relatifs à l'entreprise à mettre à jour. Seuls les champs de premier niveau de Company sont acceptés.

UpdateJobRequest

Requête de mise à jour d'une offre d'emploi.

Champs
job

Job

Obligatoire. Offre d'emploi à mettre à jour.

update_mask

FieldMask

Fortement recommandé pour une expérience de service optimale.

Si update_mask est fourni, seuls les champs spécifiés dans job sont mis à jour. Sinon, tous les champs sont mis à jour.

Masque de champ permettant de restreindre les champs mis à jour. Seuls les champs de premier niveau de Job sont acceptés.

UpdateTenantRequest

Requête de mise à jour d'un locataire spécifié.

Champs
tenant

Tenant

Obligatoire. Ressource locataire qui remplacera la ressource actuelle dans le système.

update_mask

FieldMask

Fortement recommandé pour une expérience de service optimale.

Si update_mask est fourni, seuls les champs spécifiés dans tenant sont mis à jour. Sinon, tous les champs sont mis à jour.

Masque de champ permettant de spécifier les champs locataires à mettre à jour. Seuls les champs de premier niveau de Tenant sont acceptés.

Visibilité

Obsolète. Seul le propriétaire peut voir toutes les ressources.

Énumération représentant les utilisateurs qui disposent d'un accès en lecture à la ressource.

Enums
VISIBILITY_UNSPECIFIED Valeur par défaut.
ACCOUNT_ONLY La ressource n'est visible que par le compte GCP qui la détient.
SHARED_WITH_GOOGLE La ressource est visible par le propriétaire, et peut l'être par d'autres applications et processus de Google.
SHARED_WITH_PUBLIC La ressource est visible par le propriétaire, et peut l'être par tous les autres clients API.