Cloud Talent Solution API に含まれる Company リソースは、それぞれ 1 つの会社を表します。その会社に属する求人は、その会社で募集中の職位に対して作成される求人の投稿を表します。求人には、会社名や住所などの情報と、Cloud Talent Solution サービスのリソースを内部データベースに結び付ける内部フィールドが含まれます。
会社の作成
Company を作成するには、companies
エンドポイントに POST リクエストを送信し、その際に少なくとも 2 つの必須項目を指定します。会社の作成方法の詳細については、クイックスタート: 会社と求人の作成のページをご覧ください。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
必須項目
作成や更新リクエストでは次のフィールドが必須です。
displayName
: 求人とともに表示される雇用主の名前(「Google LLC」など)。externalId
: この会社用の内部 ID。この項目により、Google のシステム内で内部 ID を会社にマッピングできます。その会社に個別の内部 ID がない場合は、このフィールドをdisplayName
と同じ値に設定します。
よく使用されるフィールド
headquartersAddress
: 会社の本社の住所。求人の勤務地とは異なる場合があります。Cloud Talent Solution で使用できる本社所在地は、会社ごとに 1 か所のみです。このサービスは、住所の位置情報の特定を試み、可能な場合は、より詳細な位置情報をderivedInfo.headquartersLocation
(出力のみ)に入力します。size
: 従業員数に基づく会社の規模を表すバケット値(MINI
からGIANT
)。列挙型とその定義については、size
のリファレンスをご覧ください。eeoText
: この会社のすべての求人に関連付けられる、雇用機会均等法の法的免責事項の文章を含む文字列。keywordSearchableJobCustomAttributes
: この会社の求人のどのcustomAttributes
にインデックスを登録して、一般的なキーワード検索で検索できるようにするかを指定します。
会社の更新
会社を更新するには、次のエンドポイントに PATCH リクエストを送信します。
PATCH https://jobs.googleapis.com/v3/COMPANY_NAME
ここで、COMPANY_NAME
は会社の name
フィールドの値です。name
は、会社の作成時、および company.get
リクエストと list
リクエストによっても返される会社の固有 ID です。
リクエストの本文には、更新対象でないフィールドも含め、リソース全体を含める必要があります。これらのフィールドは updateMask
で設定できます。updateMask
に項目を設定すると、設定した項目のみが更新され、他の項目への更新は無視されます。updateMask
を設定しない場合、すべてのフィールドが更新されます。
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
updateMask
を使用した会社の更新
Java
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Python
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
Go
Cloud Talent Solution クライアントのインストールと作成の詳細については、Cloud Talent Solution クライアント ライブラリをご覧ください。
おすすめの方法
機密の会社
機密性の高い求人を投稿する場合は、会社と同様のフィールドを設定した別の会社を作成し、displayName
や externalId
などの識別フィールドを難読化することをおすすめします。
雇用主を匿名にする場合(人材派遣会社の使用例など)は、externalId
と displayName
をランダムかつ一意の値に設定することをおすすめします。