REST Resource: projects.companies

Ressource: Unternehmen

Eine Unternehmensressource stellt ein Unternehmen im Dienst dar. Ein Unternehmen ist die Entität, zu der Jobanzeigen gehören, also die Entität, die für die Einstellung von Bewerbern für eine Stelle verantwortlich ist.

JSON-Darstellung
{
  "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
}
Felder
name

string

Erforderlich bei Aktualisierung des Unternehmens.

Der Ressourcenname eines Unternehmens. Er wird vom Dienst generiert, wenn ein Unternehmen erstellt wird.

Das Format ist „projects/{projectId}/Mandanten/{Mandanten-ID}/Companies/{company_id}“, z. B. „projects/foo/Mandanten/bar/enterprise/baz“.

Wenn keine Mandanten-ID angegeben ist, wird der Standardmandant verwendet. Beispiel: „projects/foo/company/bar“.

displayName

string

Erforderlich. Der Anzeigename des Unternehmens, z. B. „Google LLC“.

externalId

string

Erforderlich. Die Unternehmenskennzeichnung eines Kunden, mit der das Unternehmen eindeutig identifiziert wird.

Es sind maximal 255 Zeichen zulässig.

size

enum (CompanySize)

Die Unternehmensgröße des Arbeitgebers.

headquartersAddress

string

Die Adresse der Hauptniederlassung des Unternehmens, die sich vom Jobstandort unterscheiden kann. Der Dienst versucht, den Standort der angegebenen Adresse zu bestimmen, und trägt nach Möglichkeit einen genaueren Standort in DerivedInfo.headquarters_location ein.

hiringAgency

boolean

Legen Sie dieses Feld auf "true" fest, wenn es sich um die Stellenvermittlung handelt, die Jobs für andere Arbeitgeber veröffentlicht.

Falls kein Wert angegeben wird, ist der Standardwert "false".

eeoText

string

Ein Hinweistext zur Chancengleichheit bei der Arbeitsplatzsuche, der mit allen Jobs verknüpft werden soll und normalerweise in allen Rollen angezeigt wird.

Es sind maximal 500 Zeichen zulässig.

websiteUri

string

Die URI zur primären Website oder Homepage des Unternehmens, z. B. "www.google.com".

Es sind maximal 255 Zeichen zulässig.

careerSiteUri

string

Die URI zur Karrierewebsite des Arbeitgebers oder zur Karriereseite auf der Website des Arbeitgebers, z. B. "www.careers.google.com".

imageUri

string

Eine URI, unter der das Unternehmenslogo des Arbeitgebers gehostet wird.

keywordSearchableJobCustomAttributes[]

string

Eine Liste mit Schlüsseln mit filterbaren Job.custom_attributes, deren entsprechende stringValues in Stichwortsuchen verwendet werden. Jobs mit stringValues unter diesen angegebenen Feldschlüsseln werden zurückgegeben, wenn einer der Werte mit dem Suchbegriff der Suche übereinstimmt. Benutzerdefinierte Feldwerte mit Klammern, Klammern und Sonderzeichen können in der vorliegenden Form nicht durchsucht werden. Diese Suchbegriffabfragen müssen in Anführungszeichen gesetzt werden.

derivedInfo

object (DerivedInfo)

Nur Ausgabe. Abgeleitete Details über das Unternehmen.

suspended

boolean

Nur Ausgabe. Gibt an, ob ein Unternehmen durch den Dienst als gesperrt gemeldet wird und somit nicht öffentlich verfügbar ist, wenn der Jobinhalt einen verdächtigen oder missbräuchlichen Eindruck macht oder wie Spam wirkt.

CompanySize

Ein Enum, das die Größe des Unternehmens darstellt.

Enums
COMPANY_SIZE_UNSPECIFIED Standardwert, wenn die Größe nicht angegeben ist.
MINI Das Unternehmen hat weniger als 50 Mitarbeiter.
SMALL Das Unternehmen hat 50 bis 99 Mitarbeiter.
SMEDIUM Das Unternehmen hat 100 bis 499 Mitarbeiter.
MEDIUM Das Unternehmen hat 500 bis 999 Mitarbeiter.
BIG Das Unternehmen hat 1.000 bis 4.999 Mitarbeiter.
BIGGER Das Unternehmen hat 5.000 bis 9.999 Mitarbeiter.
GIANT Das Unternehmen hat mindestens 10.000 Mitarbeiter.

DerivedInfo

Abgeleitete Details über das Unternehmen.

JSON-Darstellung
{
  "headquartersLocation": {
    object (Location)
  }
}
Felder
headquartersLocation

object (Location)

Ein strukturierter Standort der Hauptniederlassung des Unternehmens, der aus Company.headquarters_address aufgelöst wird, falls angegeben.

Methoden

create

Erstellt eine neue Unternehmensentität.

delete

Löscht die angegebene Firma.

get

Ruft das angegebene Unternehmen ab.

list

Listet alle mit dem Projekt verknüpften Unternehmen auf.

patch

Aktualisiert das angegebene Unternehmen.