REST Resource: projects.companies

Ressource : Company

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.

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "externalId": string,
  "size": enum (CompanySize),
  "headquartersAddress": string,
  "hiringAgency": boolean,
  "eeoText": string,
  "websiteUri": string,
  "careerSiteUri": string,
  "imageUri": string,
  "keywordSearchableJobCustomAttributes": [
    string
  ],
  "derivedInfo": {
    object (DerivedInfo)
  },
  "suspended": boolean
}
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/{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".
displayName

string

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

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

enum (CompanySize)

Taille de l'entreprise de l'employeur.
headquartersAddress

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

boolean

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

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

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

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".
imageUri

string

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

string

Liste de clés de Job.custom_attributes filtrables, dont les stringValues correspondantes sont utilisées dans les recherches par mots clés. Les offres d'emploi contenant stringValues 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.
derivedInfo

object (DerivedInfo)

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

boolean

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.

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.

DerivedInfo

Informations dérivées concernant l'entreprise.

Représentation JSON 
{
  "headquartersLocation": {
    object (Location)
  }
}
Champs
headquartersLocation

object (Location)

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

Méthodes

create

 Crée une entreprise.

delete

 Supprime l'entreprise spécifiée.

get

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

list

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

patch

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