Method: projects.jobs.patch

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.

Requête HTTP

PATCH https://jobs.googleapis.com/v4beta1/{job.name=projects/*/jobs/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
job.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 "projects/{projectId}/tenants/{tenantId}/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 requisitionId.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "job": {
    "name": string,
    "company": string,
    "requisitionId": string,
    "title": string,
    "description": string,
    "addresses": [
      string
    ],
    "applicationInfo": {
      "emails": [
        string
      ],
      "instruction": string,
      "uris": [
        string
      ]
    },
    "jobBenefits": [
      enum (JobBenefit)
    ],
    "compensationInfo": {
      "entries": [
        {
          object (CompensationEntry)
        }
      ],
      "annualizedBaseCompensationRange": {
        object (CompensationRange)
      },
      "annualizedTotalCompensationRange": {
        object (CompensationRange)
      }
    },
    "customAttributes": {
      string: {
        object (CustomAttribute)
      },
      ...
    },
    "degreeTypes": [
      enum (DegreeType)
    ],
    "department": string,
    "employmentTypes": [
      enum (EmploymentType)
    ],
    "incentives": string,
    "languageCode": string,
    "jobLevel": enum (JobLevel),
    "promotionValue": integer,
    "qualifications": string,
    "responsibilities": string,
    "postingRegion": enum (PostingRegion),
    "visibility": enum (Visibility),
    "jobStartTime": {
      "seconds": string,
      "nanos": integer
    },
    "jobEndTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingPublishTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingExpireTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingCreateTime": {
      "seconds": string,
      "nanos": integer
    },
    "postingUpdateTime": {
      "seconds": string,
      "nanos": integer
    },
    "companyDisplayName": string,
    "derivedInfo": {
      "locations": [
        {
          object (Location)
        }
      ],
      "jobCategories": [
        enum (JobCategory)
      ]
    },
    "processingOptions": {
      "disableStreetAddressResolution": boolean,
      "htmlSanitization": enum (HtmlSanitization)
    }
  },
  "updateMask": string
}
Champs
job.company

string

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

Le format est le suivant : "projects/{projectId}/tenants/{tenantId}/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".
job.requisitionId

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, languageCode et requisitionId.

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

string

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

Le nombre maximal de caractères autorisés est de 500.
job.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.
job.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 requisitionId uniques (par exemple, "ReqA" devient "ReqA-1", "ReqA-2", etc.), car plusieurs jobs avec les mêmes company, languageCode et requisitionId ne sont pas autorisés. Si la valeur requisitionId 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.
job.applicationInfo

object (ApplicationInfo)

Informations relatives à la candidature.
job.jobBenefits[]

enum (JobBenefit)

Avantages proposés avec le poste.
job.compensationInfo

object (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é.
job.customAttributes

map (key: string, value: object (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 stringValues 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 stringValues non filtrables, la taille totale maximale de stringValues pour l'ensemble des clés est de 50 Ko.
job.degreeTypes[]

enum (DegreeType)

Niveau de formation souhaité pour le poste à pourvoir, tel que "licence" ou "master".
job.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.
job.employmentTypes[]

enum (EmploymentType)

Type(s) d'emploi d'un emploi (par exemple, full time ou part time).
job.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.
job.languageCode

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.jobLevel

enum (JobLevel)

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

integer

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.
job.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.
job.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.
job.postingRegion

enum (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.
job.visibility
(deprecated)

enum (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.jobStartTime

string (Timestamp format)

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.jobEndTime

string (Timestamp format)

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

string (Timestamp format)

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.
job.postingExpireTime

string (Timestamp format)

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 jobs.list, mais elle peut être récupérée avec l'API jobs.get, mise à jour avec l'API jobs.patch ou supprimée avec l'API jobs.delete. 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, languageCode et requisitionId.

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é, postingPublishTime doit être défini avant postingExpireTime. 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 jobEndTime 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.
job.postingCreateTime

string (Timestamp format)

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

string (Timestamp format)

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

string

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

object (DerivedInfo)

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

object (ProcessingOptions)

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

string (FieldMask format)

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

Si updateMask 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.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Job.

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.