Method: projects.tenants.companies.patch

指定した会社を更新します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
company.name

string

会社を更新する際に必要です。

会社のリソース名。これは、会社が作成されたときにサービスによって生成されます。

形式は「projects/{projectId}/tenants/{tenantId}/companies/{company_id}」です(例: 「projects/foo/tenants/bar/companies/baz」)。

テナント ID を指定しない場合は、デフォルト テナントが使用されます。たとえば、「projects/foo/companies/bar」です。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "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
}
フィールド
company.displayName

string

必須。会社の表示名(例: 「Google LLC」)。

company.externalId

string

必須。会社を一意に識別するために使用されるクライアント側の会社 ID。

最大許容文字数は 255 文字(半角相当)です。

company.size

enum (CompanySize)

雇用者の会社規模。

company.headquartersAddress

string

会社の本社の住所。求人の勤務地とは異なる場合があります。サービスでは指定された住所の位置情報の特定を試み、DerivedInfo.headquarters_location に可能な限り詳細な場所を入力します。

company.hiringAgency

boolean

他の雇用者のための求人を投稿する人材採用会社の場合は true に設定します。

指定されていない場合は、デフォルトで false になります。

company.eeoText

string

すべての求人に関連付けられ、通常はすべての役割に表示される、雇用機会均等法の法的免責事項の文章。

最大許容文字数は 500 文字(半角相当)です。

company.websiteUri

string

会社のプライマリ ウェブサイトまたはホームページを表す URI。たとえば、「https://www.google.com」です。

最大許容文字数は 255 文字(半角相当)です。

company.careerSiteUri

string

雇用者のウェブサイト上のキャリアサイトやキャリアページへの URI。たとえば、「https://careers.google.com」です。

company.imageUri

string

雇用者の会社ロゴをホストする URI。

company.keywordSearchableJobCustomAttributes[]

string

フィルタ可能な Job.custom_attributes のキーのリスト。その対応する stringValues がキーワード検索で使用されます。いずれかの値が検索キーワードに一致すると、指定された項目キーの下に stringValues を持つ求人が返されます。かっこ、角かっこ、特殊記号を含むカスタム フィールド値はそのままで検索することはできません。このようなキーワード クエリは引用符で囲む必要があります。

company.derivedInfo

object (DerivedInfo)

出力専用。会社に関する派生情報。

company.suspended

boolean

出力専用。求人内容が疑わしい、不適切である、またはスパムのように見える場合に、サービスによって会社が公開を停止するように警告されているかどうかを示します。

updateMask

string (FieldMask format)

サービス操作性向上ために強く推奨されます。

updateMask を指定すると、company で指定されたフィールドのみが更新されます。指定しない場合はすべてのフィールドが更新されます。

更新する会社項目を指定する項目マスク。Company の最上位のフィールドのみがサポートされています。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"

レスポンスの本文

成功した場合、レスポンスの本文には Company のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、認証の概要をご覧ください。