GOgoogle
projects

POST /v4/projects/{projectsId}/tenants/{tenantsId}/companies

Creates a new company entity.

Request

  • Base URL
    https://jobs.googleapis.com
  • Auth
    • OAuth 2 and OAuth 2
      Implicithttps://accounts.google.com/o/oauth2/auth
      Scopeshttps://www.googleapis.com/auth/cloud-platform
      Authorization codehttps://accounts.google.com/o/oauth2/auth
      Token URLhttps://accounts.google.com/o/oauth2/token
      Scopeshttps://www.googleapis.com/auth/cloud-platform
    • or OAuth 2 and OAuth 2
      Implicithttps://accounts.google.com/o/oauth2/auth
      Scopeshttps://www.googleapis.com/auth/jobs
      Authorization codehttps://accounts.google.com/o/oauth2/auth
      Token URLhttps://accounts.google.com/o/oauth2/token
      Scopeshttps://www.googleapis.com/auth/jobs

Path parameters

projectsIdstring required
tenantsIdstring required

Request body

careerSiteUristring

The URI to employer's career site or careers page on the employer's web site, for example, "https://careers.google.com".

displayNamestring

Required. The display name of the company, for example, "Google LLC".

eeoTextstring

Equal Employment Opportunity legal disclaimer text to be associated with all jobs, and typically to be displayed in all roles. The maximum number of allowed characters is 500.

externalIdstring

Required. Client side company identifier, used to uniquely identify the company. The maximum number of allowed characters is 255.

headquartersAddressstring

The street address of the company's main headquarters, which may be different from the job location. The service attempts to geolocate the provided address, and populates a more specific location wherever possible in DerivedInfo.headquarters_location.

hiringAgencyboolean

Set to true if it is the hiring agency that post jobs for other employers. Defaults to false if not provided.

imageUristring

A URI that hosts the employer's company logo.

keywordSearchableJobCustomAttributesstring[]

This field is deprecated. Please set the searchability of the custom attribute in the Job.custom_attributes going forward. A list of keys of filterable Job.custom_attributes, whose corresponding string_values are used in keyword searches. Jobs with string_values under these specified field keys are returned if any of the values match the search keyword. Custom field values with parenthesis, brackets and special symbols are not searchable as-is, and those keyword queries must be surrounded by quotes.

namestring

Required during company update. The resource name for a company. This is generated by the service when a company is created. The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for example, "projects/foo/tenants/bar/companies/baz".

size'COMPANY_SIZE_UNSPECIFIED' | 'MINI' | 'SMALL' | 'SMEDIUM' | 'MEDIUM' | 'BIG' | 'BIGGER' | 'GIANT'

The employer's company size.

suspendedboolean

Output only. Indicates whether a company is flagged to be suspended from public availability by the service when job content appears suspicious, abusive, or spammy.

websiteUristring

The URI representing the company's primary web site or home page, for example, "https://www.google.com". The maximum number of allowed characters is 255.

Response

Successful response

careerSiteUristring

The URI to employer's career site or careers page on the employer's web site, for example, "https://careers.google.com".

displayNamestring

Required. The display name of the company, for example, "Google LLC".

eeoTextstring

Equal Employment Opportunity legal disclaimer text to be associated with all jobs, and typically to be displayed in all roles. The maximum number of allowed characters is 500.

externalIdstring

Required. Client side company identifier, used to uniquely identify the company. The maximum number of allowed characters is 255.

headquartersAddressstring

The street address of the company's main headquarters, which may be different from the job location. The service attempts to geolocate the provided address, and populates a more specific location wherever possible in DerivedInfo.headquarters_location.

hiringAgencyboolean

Set to true if it is the hiring agency that post jobs for other employers. Defaults to false if not provided.

imageUristring

A URI that hosts the employer's company logo.

keywordSearchableJobCustomAttributesstring[]

This field is deprecated. Please set the searchability of the custom attribute in the Job.custom_attributes going forward. A list of keys of filterable Job.custom_attributes, whose corresponding string_values are used in keyword searches. Jobs with string_values under these specified field keys are returned if any of the values match the search keyword. Custom field values with parenthesis, brackets and special symbols are not searchable as-is, and those keyword queries must be surrounded by quotes.

namestring

Required during company update. The resource name for a company. This is generated by the service when a company is created. The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for example, "projects/foo/tenants/bar/companies/baz".

size'COMPANY_SIZE_UNSPECIFIED' | 'MINI' | 'SMALL' | 'SMEDIUM' | 'MEDIUM' | 'BIG' | 'BIGGER' | 'GIANT'

The employer's company size.

suspendedboolean

Output only. Indicates whether a company is flagged to be suspended from public availability by the service when job content appears suspicious, abusive, or spammy.

websiteUristring

The URI representing the company's primary web site or home page, for example, "https://www.google.com". The maximum number of allowed characters is 255.

Changes

No recorded changes to this operation across all 4 revisions of this API.