Cette page a été traduite par l'API Cloud Translation.

JobQuery

Représentation JSON
LocationFilter
- Représentation JSON
TelecommutePreference
CommuteFilter
- Représentation JSON
CommuteMethod
RoadTraffic
TimeOfDay
- Représentation JSON
CompensationFilter
- Représentation JSON
FilterType
TimestampRange
- Représentation JSON

Requête obligatoire pour effectuer une recherche.

Représentation JSON

Représentation JSON
{ "query": string, "queryLanguageCode": string, "companies": [ string ], "locationFilters": [ { object (`LocationFilter`) } ], "jobCategories": [ enum (`JobCategory`) ], "commuteFilter": { object (`CommuteFilter`) }, "companyDisplayNames": [ string ], "compensationFilter": { object (`CompensationFilter`) }, "customAttributeFilter": string, "disableSpellCheck": boolean, "employmentTypes": [ enum (`EmploymentType`) ], "languageCodes": [ string ], "publishTimeRange": { object (`TimestampRange`) }, "excludedJobs": [ string ] }

{
  "query": string,
  "queryLanguageCode": string,
  "companies": [
    string
  ],
  "locationFilters": [
    {
      object (LocationFilter)
    }
  ],
  "jobCategories": [
    enum (JobCategory)
  ],
  "commuteFilter": {
    object (CommuteFilter)
  },
  "companyDisplayNames": [
    string
  ],
  "compensationFilter": {
    object (CompensationFilter)
  },
  "customAttributeFilter": string,
  "disableSpellCheck": boolean,
  "employmentTypes": [
    enum (EmploymentType)
  ],
  "languageCodes": [
    string
  ],
  "publishTimeRange": {
    object (TimestampRange)
  },
  "excludedJobs": [
    string
  ]
}

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.
`queryLanguageCode`	`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/{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". La recherche peut comporter jusqu'à 20 filtres d'entreprise.
`locationFilters[]`	`object (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.
`jobCategories[]`	`enum (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.
`commuteFilter`	`object (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, `locationFilters` est ignoré. Le tri par temps de trajet domicile-travail n'est actuellement pas possible.
`companyDisplayNames[]`	`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.
`compensationFilter`	`object (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.
`customAttributeFilter`	`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`
`disableSpellCheck`	`boolean` 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.
`employmentTypes[]`	`enum (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.
`languageCodes[]`	`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.
`publishTimeRange`	`object (TimestampRange)` La recherche s'applique aux offres d'emploi publiées dans une plage spécifiée par ce filtre.
`excludedJobs[]`	`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é.

LocationFilter

Région géographique de la recherche.

Représentation JSON
{ "address": string, "regionCode": string, "latLng": { object (`LatLng`) }, "distanceInMiles": number, "telecommutePreference": enum (`TelecommutePreference`), "negated": boolean }

Champs
`address`	`string` Nom de l'adresse, tel que "Mountain View" ou "Région de la baie de San Francisco".
`regionCode`	`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.
`latLng`	`object (LatLng)` Latitude et longitude du centre géographique à partir duquel effectuer la recherche. Ce champ est ignoré si `address` est fourni.
`distanceInMiles`	`number` Champ 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.
`telecommutePreference`	`enum (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 `latLng` 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`	`boolean` 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.

CommuteFilter

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

Représentation JSON

Représentation JSON
{ "commuteMethod": enum (`CommuteMethod`), "startCoordinates": { object (`LatLng`) }, "travelDuration": string, "allowImpreciseAddresses": boolean, // Union field `traffic_option` can be only one of the following: "roadTraffic": enum (`RoadTraffic`), "departureTime": { object (`TimeOfDay`) } // End of list of possible types for union field `traffic_option`. }

{
  "commuteMethod": enum (CommuteMethod),
  "startCoordinates": {
    object (LatLng)
  },
  "travelDuration": string,
  "allowImpreciseAddresses": boolean,

  // Union field traffic_option can be only one of the following:
  "roadTraffic": enum (RoadTraffic),
  "departureTime": {
    object (TimeOfDay)
  }
  // End of list of possible types for union field traffic_option.
}

Champs
`commuteMethod`	`enum (CommuteMethod)` Obligatoire. Moyen de transport pour lequel calculer le temps de trajet domicile-travail.
`startCoordinates`	`object (LatLng)` Obligatoire. Latitude et longitude du lieu à partir duquel calculer le temps de trajet.
`travelDuration`	`string (Duration format)` Obligatoire. Durée maximale du trajet en secondes. La valeur maximale autorisée est de `3600s` (une heure). Le format est le suivant : `123s`. Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par "`s`". Example : `"3.5s"`.
`allowImpreciseAddresses`	`boolean` 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 :
`roadTraffic`	`enum (RoadTraffic)` Spécifie la densité du trafic à utiliser pour le calcul du temps de trajet domicile-travail.
`departureTime`	`object (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.

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.

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.

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer }

Champs
`hours`	`integer` Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
`minutes`	`integer` Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.
`seconds`	`integer` Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
`nanos`	`integer` Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.

CompensationFilter

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

Représentation JSON
{ "type": enum (`FilterType`), "units": [ enum (`CompensationUnit`) ], "range": { object (`CompensationRange`) }, "includeJobsWithUnspecifiedCompensationRange": boolean }

Champs
`type`	`enum (FilterType)` Obligatoire. Type de filtre.
`units[]`	`enum (CompensationUnit)` Obligatoire. Spécifiez le paramètre `base compensation entry's` `CompensationInfo.CompensationUnit` souhaité.
`range`	`object (CompensationRange)` Plage de rémunération.
`includeJobsWithUnspecifiedCompensationRange`	`boolean` 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`.

TimestampRange

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

Représentation JSON
{ "startTime": string, "endTime": string }

Champs

Champs
`startTime`	`string (Timestamp format)` Début de la période (inclus).
`endTime`	`string (Timestamp format)` Fin de la période (exclue).

startTime

string (Timestamp format)

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

endTime

string (Timestamp format)

Fin de la période (exclue).