legacy-libs/google-proto-files/google/cloud/talent/v4beta1/company.proto

   1 // Copyright 2019 Google LLC.
   2 //
   3 // Licensed under the Apache License, Version 2.0 (the "License");
   4 // you may not use this file except in compliance with the License.
   5 // You may obtain a copy of the License at
   6 //
   7 //     http://www.apache.org/licenses/LICENSE-2.0
   8 //
   9 // Unless required by applicable law or agreed to in writing, software
  10 // distributed under the License is distributed on an "AS IS" BASIS,
  11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 // See the License for the specific language governing permissions and
  13 // limitations under the License.
  14 //
  15
  16 syntax = "proto3";
  17
  18 package google.cloud.talent.v4beta1;
  19
  20 import "google/api/annotations.proto";
  21 import "google/cloud/talent/v4beta1/common.proto";
  22
  23 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
  24 option java_multiple_files = true;
  25 option java_outer_classname = "CompanyResourceProto";
  26 option java_package = "com.google.cloud.talent.v4beta1";
  27 option objc_class_prefix = "CTS";
  28
  29 // A Company resource represents a company in the service. A company is the
  30 // entity that owns job postings, that is, the hiring entity responsible for
  31 // employing applicants for the job position.
  32 message Company {
  33   // Derived details about the company.
  34   message DerivedInfo {
  35     // A structured headquarters location of the company, resolved from
  36     // [Company.hq_location][] if provided.
  37     Location headquarters_location = 1;
  38   }
  39
  40   // Required during company update.
  41   //
  42   // The resource name for a company. This is generated by the service when a
  43   // company is created.
  44   //
  45   // The format is "projects/{project_id}/companies/{company_id}", for example,
  46   // "projects/api-test-project/companies/foo".
  47   string name = 1;
  48
  49   // Required.
  50   //
  51   // The display name of the company, for example, "Google, LLC".
  52   string display_name = 2;
  53
  54   // Required.
  55   //
  56   // Client side company identifier, used to uniquely identify the
  57   // company.
  58   //
  59   // The maximum number of allowed characters is 255.
  60   string external_id = 3;
  61
  62   // Optional.
  63   //
  64   // The employer's company size.
  65   CompanySize size = 4;
  66
  67   // Optional.
  68   //
  69   // The street address of the company's main headquarters, which may be
  70   // different from the job location. The service attempts
  71   // to geolocate the provided address, and populates a more specific
  72   // location wherever possible in
  73   // [DerivedInfo.headquarters_location][google.cloud.talent.v4beta1.Company.DerivedInfo.headquarters_location].
  74   string headquarters_address = 5;
  75
  76   // Optional.
  77   //
  78   // Set to true if it is the hiring agency that post jobs for other
  79   // employers.
  80   //
  81   // Defaults to false if not provided.
  82   bool hiring_agency = 6;
  83
  84   // Optional.
  85   //
  86   // Equal Employment Opportunity legal disclaimer text to be
  87   // associated with all jobs, and typically to be displayed in all
  88   // roles.
  89   //
  90   // The maximum number of allowed characters is 500.
  91   string eeo_text = 7;
  92
  93   // Optional.
  94   //
  95   // The URI representing the company's primary web site or home page,
  96   // for example, "https://www.google.com".
  97   //
  98   // The maximum number of allowed characters is 255.
  99   string website_uri = 8;
 100
 101   // Optional.
 102   //
 103   // The URI to employer's career site or careers page on the employer's web
 104   // site, for example, "https://careers.google.com".
 105   string career_site_uri = 9;
 106
 107   // Optional.
 108   //
 109   // A URI that hosts the employer's company logo.
 110   string image_uri = 10;
 111
 112   // Optional.
 113   //
 114   // A list of keys of filterable
 115   // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes],
 116   // whose corresponding `string_values` are used in keyword search. Jobs with
 117   // `string_values` under these specified field keys are returned if any
 118   // of the values matches the search keyword. Custom field values with
 119   // parenthesis, brackets and special symbols won't be properly searchable,
 120   // and those keyword queries need to be surrounded by quotes.
 121   repeated string keyword_searchable_job_custom_attributes = 11;
 122
 123   // Output only. Derived details about the company.
 124   DerivedInfo derived_info = 12;
 125
 126   // Output only. Indicates whether a company is flagged to be suspended from
 127   // public availability by the service when job content appears suspicious,
 128   // abusive, or spammy.
 129   bool suspended = 13;
 130 }