REST Resource: projects.companies

资源：公司

公司资源表示正常运营的公司。公司是拥有招聘信息帖子的实体，即负责雇用职位申请人的招聘单位。

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
}
字段
name

string

更新公司时必须填写。

公司的资源名称。此名称是在创建公司时由服务生成的。

格式为“projects/{projectId}/tenants/{tenantId}/companies/{company_id}”，例如“projects/foo/tenants/bar/companies/baz”。

如果未指定租户 ID，则使用默认租户。例如“projects/foo/companies/bar”。
displayName

string

必需。公司的显示名称，例如“Google LLC”。
externalId

string

必需。客户端公司标识符，用于唯一标识公司。

允许的最大字符数为 255。
size

enum (CompanySize)

雇主的公司规模。
headquartersAddress

string

公司总部的街道地址，可能与工作地点不同。该服务会尝试对提供的地址进行地理定位，并尽可能在 DerivedInfo.headquarters_location 中填充更具体的位置。
hiringAgency

boolean

如果是为其他雇主发布职位的招聘代理机构，则设置为 true。

如果未提供，则默认为 false。
eeoText

string

与所有招聘信息关联的平等就业机会法律免责声明文本，通常显示在所有角色中。

允许的最大字符数为 500。
websiteUri

string

该 URI 表示公司主要网站或主页的网址，例如“https://www.google.com”。

允许的最大字符数为 255。
careerSiteUri

string

该 URI 表示雇主招聘网站或雇主网站上的招聘页面的网址，例如“https://careers.google.com”。
imageUri

string

托管雇主公司徽标的 URI。
keywordSearchableJobCustomAttributes[]

string

可过滤 Job.custom_attributes 的键列表，其对应的 stringValues 用于关键字搜索。如果有任何值与搜索关键字匹配，则返回这些指定字段键下具有 stringValues 的职位。带圆括号、方括号和特殊符号的自定义字段值不能按原样搜索，这些关键字查询必须用引号括起来。
derivedInfo

object (DerivedInfo)

仅限输出。有关公司的衍生详细信息。
suspended

boolean

仅限输出。当公司招聘信息的内容显示为可疑、滥用或垃圾内容时，指示该公司是否被服务标记为暂停向公众开放。

CompanySize

表示公司规模的枚举。

枚举
COMPANY_SIZE_UNSPECIFIED 如果未指定规模，则使用默认值。
MINI 该公司员工不足 50 人。
SMALL 该公司拥有 50 至 99 名员工。
SMEDIUM 该公司拥有 100 至 499 名员工。
MEDIUM 该公司拥有 500 至 999 名员工。
BIG 该公司拥有 1000 至 4999 名员工。
BIGGER 该公司拥有 5000 至 9999 名员工。
GIANT 该公司拥有 10000 或更多名员工。

DerivedInfo

有关公司的衍生详细信息。

JSON 表示法 
{
  "headquartersLocation": {
    object (Location)
  }
}
字段
headquartersLocation

object (Location)

公司的结构化总部地点，从 Company.headquarters_address 解析（如果提供）。

方法

create

 创建新的公司实体。

delete

 删除指定的公司。

get

 检索指定的公司。

list

 列出与项目关联的所有公司。

patch

 更新指定的公司。