Method: projects.tenants.companies.patch

Aktualisiert das angegebene Unternehmen.

HTTP-Anfrage

PATCH https://jobs.googleapis.com/v4beta1/{company.name=projects/*/tenants/*/companies/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
company.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“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "company": {
    "name": string,
    "displayName": string,
    "externalId": string,
    "size": enum (CompanySize),
    "headquartersAddress": string,
    "hiringAgency": boolean,
    "eeoText": string,
    "websiteUri": string,
    "careerSiteUri": string,
    "imageUri": string,
    "keywordSearchableJobCustomAttributes": [
      string
    ],
    "derivedInfo": {
      "headquartersLocation": {
        object (Location)
      }
    },
    "suspended": boolean
  },
  "updateMask": string
}
Felder
company.displayName

string

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

company.externalId

string

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

Es sind maximal 255 Zeichen zulässig.

company.size

enum (CompanySize)

Die Unternehmensgröße des Arbeitgebers.

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

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

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

company.websiteUri

string

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

Es sind maximal 255 Zeichen zulässig.

company.careerSiteUri

string

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

company.imageUri

string

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

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

company.derivedInfo

object (DerivedInfo)

Nur Ausgabe. Abgeleitete Details über das Unternehmen.

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

updateMask

string (FieldMask format)

Dringend empfohlen für eine optimale Servicequalität.

Wenn updateMask angegeben ist, werden nur die angegebenen Felder in company aktualisiert. Andernfalls werden alle Felder aktualisiert.

Eine Feldmaske zur Angabe der Unternehmensfelder, die aktualisiert werden sollen. Es werden nur Felder der obersten Ebene von Company unterstützt.

Eine kommagetrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Company.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.