Cloud Talent Solution API . projects . companies

Instance Methods

create(parent, body=None, x__xgafv=None)

Creates a new company entity.

delete(name, x__xgafv=None)

Deletes specified company.

get(name, x__xgafv=None)

Retrieves specified company.

list(parent, requireOpenJobs=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all companies associated with the service account.

list_next(previous_request, previous_response)

Retrieves the next page of results.

patch(name, body=None, x__xgafv=None)

Updates specified company. Company names can't be updated. To update a

Method Details

create(parent, body=None, x__xgafv=None)
Creates a new company entity.

Args:
  parent: string, Required. Resource name of the project under which the company is created.

The format is "projects/{project_id}", for example,
"projects/api-test-project". (required)
  body: object, The request body.
    The object takes the form of:

{ # Input only.
      # 
      # The Request of the CreateCompany method.
    "company": { # A Company resource represents a company in the service. A company is the # Required. The company to be created.
        # entity that owns job postings, that is, the hiring entity responsible for
        # employing applicants for the job position.
      "name": "A String", # 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}/companies/{company_id}", for example,
          # "projects/api-test-project/companies/foo".
      "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
      "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
        "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
            # Company.hq_location if provided.
            #
            # A resource that represents a location with full geographic information.
          "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
              # such as postal delivery and payments addresses. Given a postal address,
              # a postal service can deliver items to a premises, P.O. Box, or other
              # delivery location.
              # Given a postal address, a postal service can deliver items to a premise, P.O.
              # Box or similar.
              # It is not intended to model geographical locations (roads, towns,
              # mountains).
              #
              # In typical usage an address would be created via user input or from importing
              # existing data, depending on the type of process.
              #
              # Advice on address input / editing:
              #  - Use an i18n-ready address widget such as
              #    https://github.com/google/libaddressinput)
              # - Users should not be presented with UI elements for input or editing of
              #   fields outside countries where that field is used.
              #
              # For more guidance on how to use this schema, please see:
              # https://support.google.com/business/answer/6397478
            "organization": "A String", # Optional. The name of the organization at the address.
            "sublocality": "A String", # Optional. Sublocality of the address.
                # For example, this can be neighborhoods, boroughs, districts.
            "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
                # known). This is often the UI language of the input form or is expected
                # to match one of the languages used in the address' country/region, or their
                # transliterated equivalents.
                # This can affect formatting in certain countries, but is not critical
                # to the correctness of the data and will never affect any validation or
                # other non-formatting related operations.
                #
                # If this value is not known, it should be omitted (rather than specifying a
                # possibly incorrect default).
                #
                # Examples: "zh-Hant", "ja", "ja-Latn", "en".
            "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
                # addresses of a country or region.
                # For example, this can be a state, a province, an oblast, or a prefecture.
                # Specifically, for Spain this is the province and not the autonomous
                # community (e.g. "Barcelona" and not "Catalonia").
                # Many countries don't use an administrative area in postal addresses. E.g.
                # in Switzerland this should be left unpopulated.
            "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
                # Examples: US city, IT comune, UK post town.
                # In regions of the world where localities are not well defined or do not fit
                # into this structure well, leave locality empty and use address_lines.
            "recipients": [ # Optional. The recipient at the address.
                # This field may, under certain circumstances, contain multiline information.
                # For example, it might contain "care of" information.
              "A String",
            ],
            "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
                # the latest revision.
                #
                # All new revisions **must** be backward compatible with old revisions.
            "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
                # postal codes to be present, but where they are used, they may trigger
                # additional validation with other parts of the address (e.g. state/zip
                # validation in the U.S.A.).
            "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
                # in most regions. Where it is used, the value is either a string like
                # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
                # alone, representing the "sector code" (Jamaica), "delivery area indicator"
                # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
            "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
                # is never inferred and it is up to the user to ensure the value is
                # correct. See http://cldr.unicode.org/ and
                # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
                # for details. Example: "CH" for Switzerland.
            "addressLines": [ # Unstructured address lines describing the lower levels of an address.
                #
                # Because values in address_lines do not have type information and may
                # sometimes contain multiple values in a single field (e.g.
                # "Austin, TX"), it is important that the line order is clear. The order of
                # address lines should be "envelope order" for the country/region of the
                # address. In places where this can vary (e.g. Japan), address_language is
                # used to make it explicit (e.g. "ja" for large-to-small ordering and
                # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
                # an address can be selected based on the language.
                #
                # The minimum permitted structural representation of an address consists
                # of a region_code with all remaining information placed in the
                # address_lines. It would be possible to format such an address very
                # approximately without geocoding, but no semantic reasoning could be
                # made about any of the address components until it was at least
                # partially resolved.
                #
                # Creating an address only containing a region_code and address_lines, and
                # then geocoding is the recommended way to handle completely unstructured
                # addresses (as opposed to guessing which parts of the address should be
                # localities or administrative areas).
              "A String",
            ],
          },
          "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
              # location bounding box in which a circle with the specified radius
              # centered from LatLng covers the area associated with the job location.
              # For example, currently, "Mountain View, CA, USA" has a radius of
              # 6.17 miles.
          "locationType": "A String", # The type of a location, which corresponds to the address lines field of
              # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
              # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
              # LocationType#LOCALITY.
          "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
              # of doubles representing degrees latitude and degrees longitude. Unless
              # specified otherwise, this must conform to the
              # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
              # standard</a>. Values must be within normalized ranges.
            "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
            "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
          },
        },
      },
      "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
          # site, for example, "https://careers.google.com".
      "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
          # corresponding `string_values` are used in keyword search. Jobs with
          # `string_values` under these specified field keys are returned if any
          # of the values matches the search keyword. Custom field values with
          # parenthesis, brackets and special symbols won't be properly searchable,
          # and those keyword queries need to be surrounded by quotes.
        "A String",
      ],
      "size": "A String", # Optional. The employer's company size.
      "headquartersAddress": "A String", # Optional. 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.
      "suspended": True or False, # 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.
      "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
      "websiteUri": "A String", # Optional. 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.
      "eeoText": "A String", # Optional. 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.
      "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
          # company.
          #
          # The maximum number of allowed characters is 255.
      "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
          # employers.
          #
          # Defaults to false if not provided.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A Company resource represents a company in the service. A company is the
      # entity that owns job postings, that is, the hiring entity responsible for
      # employing applicants for the job position.
    "name": "A String", # 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}/companies/{company_id}", for example,
        # "projects/api-test-project/companies/foo".
    "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
    "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
      "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
          # Company.hq_location if provided.
          #
          # A resource that represents a location with full geographic information.
        "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
            # such as postal delivery and payments addresses. Given a postal address,
            # a postal service can deliver items to a premises, P.O. Box, or other
            # delivery location.
            # Given a postal address, a postal service can deliver items to a premise, P.O.
            # Box or similar.
            # It is not intended to model geographical locations (roads, towns,
            # mountains).
            #
            # In typical usage an address would be created via user input or from importing
            # existing data, depending on the type of process.
            #
            # Advice on address input / editing:
            #  - Use an i18n-ready address widget such as
            #    https://github.com/google/libaddressinput)
            # - Users should not be presented with UI elements for input or editing of
            #   fields outside countries where that field is used.
            #
            # For more guidance on how to use this schema, please see:
            # https://support.google.com/business/answer/6397478
          "organization": "A String", # Optional. The name of the organization at the address.
          "sublocality": "A String", # Optional. Sublocality of the address.
              # For example, this can be neighborhoods, boroughs, districts.
          "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
              # known). This is often the UI language of the input form or is expected
              # to match one of the languages used in the address' country/region, or their
              # transliterated equivalents.
              # This can affect formatting in certain countries, but is not critical
              # to the correctness of the data and will never affect any validation or
              # other non-formatting related operations.
              #
              # If this value is not known, it should be omitted (rather than specifying a
              # possibly incorrect default).
              #
              # Examples: "zh-Hant", "ja", "ja-Latn", "en".
          "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
              # addresses of a country or region.
              # For example, this can be a state, a province, an oblast, or a prefecture.
              # Specifically, for Spain this is the province and not the autonomous
              # community (e.g. "Barcelona" and not "Catalonia").
              # Many countries don't use an administrative area in postal addresses. E.g.
              # in Switzerland this should be left unpopulated.
          "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
              # Examples: US city, IT comune, UK post town.
              # In regions of the world where localities are not well defined or do not fit
              # into this structure well, leave locality empty and use address_lines.
          "recipients": [ # Optional. The recipient at the address.
              # This field may, under certain circumstances, contain multiline information.
              # For example, it might contain "care of" information.
            "A String",
          ],
          "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
              # the latest revision.
              #
              # All new revisions **must** be backward compatible with old revisions.
          "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
              # postal codes to be present, but where they are used, they may trigger
              # additional validation with other parts of the address (e.g. state/zip
              # validation in the U.S.A.).
          "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
              # in most regions. Where it is used, the value is either a string like
              # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
              # alone, representing the "sector code" (Jamaica), "delivery area indicator"
              # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
          "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
              # is never inferred and it is up to the user to ensure the value is
              # correct. See http://cldr.unicode.org/ and
              # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
              # for details. Example: "CH" for Switzerland.
          "addressLines": [ # Unstructured address lines describing the lower levels of an address.
              #
              # Because values in address_lines do not have type information and may
              # sometimes contain multiple values in a single field (e.g.
              # "Austin, TX"), it is important that the line order is clear. The order of
              # address lines should be "envelope order" for the country/region of the
              # address. In places where this can vary (e.g. Japan), address_language is
              # used to make it explicit (e.g. "ja" for large-to-small ordering and
              # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
              # an address can be selected based on the language.
              #
              # The minimum permitted structural representation of an address consists
              # of a region_code with all remaining information placed in the
              # address_lines. It would be possible to format such an address very
              # approximately without geocoding, but no semantic reasoning could be
              # made about any of the address components until it was at least
              # partially resolved.
              #
              # Creating an address only containing a region_code and address_lines, and
              # then geocoding is the recommended way to handle completely unstructured
              # addresses (as opposed to guessing which parts of the address should be
              # localities or administrative areas).
            "A String",
          ],
        },
        "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
            # location bounding box in which a circle with the specified radius
            # centered from LatLng covers the area associated with the job location.
            # For example, currently, "Mountain View, CA, USA" has a radius of
            # 6.17 miles.
        "locationType": "A String", # The type of a location, which corresponds to the address lines field of
            # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
            # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
            # LocationType#LOCALITY.
        "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
            # of doubles representing degrees latitude and degrees longitude. Unless
            # specified otherwise, this must conform to the
            # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
            # standard</a>. Values must be within normalized ranges.
          "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
          "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
        },
      },
    },
    "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
        # site, for example, "https://careers.google.com".
    "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
        # corresponding `string_values` are used in keyword search. Jobs with
        # `string_values` under these specified field keys are returned if any
        # of the values matches the search keyword. Custom field values with
        # parenthesis, brackets and special symbols won't be properly searchable,
        # and those keyword queries need to be surrounded by quotes.
      "A String",
    ],
    "size": "A String", # Optional. The employer's company size.
    "headquartersAddress": "A String", # Optional. 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.
    "suspended": True or False, # 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.
    "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
    "websiteUri": "A String", # Optional. 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.
    "eeoText": "A String", # Optional. 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.
    "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
        # company.
        #
        # The maximum number of allowed characters is 255.
    "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
        # employers.
        #
        # Defaults to false if not provided.
  }
delete(name, x__xgafv=None)
Deletes specified company.
Prerequisite: The company has no jobs associated with it.

Args:
  name: string, Required. The resource name of the company to be deleted.

The format is "projects/{project_id}/companies/{company_id}", for example,
"projects/api-test-project/companies/foo". (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated
      # empty messages in your APIs. A typical example is to use it as the request
      # or the response type of an API method. For instance:
      #
      #     service Foo {
      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
      #     }
      #
      # The JSON representation for `Empty` is empty JSON object `{}`.
  }
get(name, x__xgafv=None)
Retrieves specified company.

Args:
  name: string, Required. The resource name of the company to be retrieved.

The format is "projects/{project_id}/companies/{company_id}", for example,
"projects/api-test-project/companies/foo". (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A Company resource represents a company in the service. A company is the
      # entity that owns job postings, that is, the hiring entity responsible for
      # employing applicants for the job position.
    "name": "A String", # 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}/companies/{company_id}", for example,
        # "projects/api-test-project/companies/foo".
    "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
    "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
      "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
          # Company.hq_location if provided.
          #
          # A resource that represents a location with full geographic information.
        "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
            # such as postal delivery and payments addresses. Given a postal address,
            # a postal service can deliver items to a premises, P.O. Box, or other
            # delivery location.
            # Given a postal address, a postal service can deliver items to a premise, P.O.
            # Box or similar.
            # It is not intended to model geographical locations (roads, towns,
            # mountains).
            #
            # In typical usage an address would be created via user input or from importing
            # existing data, depending on the type of process.
            #
            # Advice on address input / editing:
            #  - Use an i18n-ready address widget such as
            #    https://github.com/google/libaddressinput)
            # - Users should not be presented with UI elements for input or editing of
            #   fields outside countries where that field is used.
            #
            # For more guidance on how to use this schema, please see:
            # https://support.google.com/business/answer/6397478
          "organization": "A String", # Optional. The name of the organization at the address.
          "sublocality": "A String", # Optional. Sublocality of the address.
              # For example, this can be neighborhoods, boroughs, districts.
          "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
              # known). This is often the UI language of the input form or is expected
              # to match one of the languages used in the address' country/region, or their
              # transliterated equivalents.
              # This can affect formatting in certain countries, but is not critical
              # to the correctness of the data and will never affect any validation or
              # other non-formatting related operations.
              #
              # If this value is not known, it should be omitted (rather than specifying a
              # possibly incorrect default).
              #
              # Examples: "zh-Hant", "ja", "ja-Latn", "en".
          "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
              # addresses of a country or region.
              # For example, this can be a state, a province, an oblast, or a prefecture.
              # Specifically, for Spain this is the province and not the autonomous
              # community (e.g. "Barcelona" and not "Catalonia").
              # Many countries don't use an administrative area in postal addresses. E.g.
              # in Switzerland this should be left unpopulated.
          "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
              # Examples: US city, IT comune, UK post town.
              # In regions of the world where localities are not well defined or do not fit
              # into this structure well, leave locality empty and use address_lines.
          "recipients": [ # Optional. The recipient at the address.
              # This field may, under certain circumstances, contain multiline information.
              # For example, it might contain "care of" information.
            "A String",
          ],
          "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
              # the latest revision.
              #
              # All new revisions **must** be backward compatible with old revisions.
          "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
              # postal codes to be present, but where they are used, they may trigger
              # additional validation with other parts of the address (e.g. state/zip
              # validation in the U.S.A.).
          "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
              # in most regions. Where it is used, the value is either a string like
              # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
              # alone, representing the "sector code" (Jamaica), "delivery area indicator"
              # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
          "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
              # is never inferred and it is up to the user to ensure the value is
              # correct. See http://cldr.unicode.org/ and
              # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
              # for details. Example: "CH" for Switzerland.
          "addressLines": [ # Unstructured address lines describing the lower levels of an address.
              #
              # Because values in address_lines do not have type information and may
              # sometimes contain multiple values in a single field (e.g.
              # "Austin, TX"), it is important that the line order is clear. The order of
              # address lines should be "envelope order" for the country/region of the
              # address. In places where this can vary (e.g. Japan), address_language is
              # used to make it explicit (e.g. "ja" for large-to-small ordering and
              # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
              # an address can be selected based on the language.
              #
              # The minimum permitted structural representation of an address consists
              # of a region_code with all remaining information placed in the
              # address_lines. It would be possible to format such an address very
              # approximately without geocoding, but no semantic reasoning could be
              # made about any of the address components until it was at least
              # partially resolved.
              #
              # Creating an address only containing a region_code and address_lines, and
              # then geocoding is the recommended way to handle completely unstructured
              # addresses (as opposed to guessing which parts of the address should be
              # localities or administrative areas).
            "A String",
          ],
        },
        "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
            # location bounding box in which a circle with the specified radius
            # centered from LatLng covers the area associated with the job location.
            # For example, currently, "Mountain View, CA, USA" has a radius of
            # 6.17 miles.
        "locationType": "A String", # The type of a location, which corresponds to the address lines field of
            # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
            # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
            # LocationType#LOCALITY.
        "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
            # of doubles representing degrees latitude and degrees longitude. Unless
            # specified otherwise, this must conform to the
            # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
            # standard</a>. Values must be within normalized ranges.
          "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
          "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
        },
      },
    },
    "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
        # site, for example, "https://careers.google.com".
    "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
        # corresponding `string_values` are used in keyword search. Jobs with
        # `string_values` under these specified field keys are returned if any
        # of the values matches the search keyword. Custom field values with
        # parenthesis, brackets and special symbols won't be properly searchable,
        # and those keyword queries need to be surrounded by quotes.
      "A String",
    ],
    "size": "A String", # Optional. The employer's company size.
    "headquartersAddress": "A String", # Optional. 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.
    "suspended": True or False, # 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.
    "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
    "websiteUri": "A String", # Optional. 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.
    "eeoText": "A String", # Optional. 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.
    "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
        # company.
        #
        # The maximum number of allowed characters is 255.
    "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
        # employers.
        #
        # Defaults to false if not provided.
  }
list(parent, requireOpenJobs=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists all companies associated with the service account.

Args:
  parent: string, Required. Resource name of the project under which the company is created.

The format is "projects/{project_id}", for example,
"projects/api-test-project". (required)
  requireOpenJobs: boolean, Optional. Set to true if the companies requested must have open jobs.

Defaults to false.

If true, at most page_size of companies are fetched, among which
only those with open jobs are returned.
  pageSize: integer, Optional. The maximum number of companies to be returned, at most 100.
Default is 100 if a non-positive number is provided.
  pageToken: string, Optional. The starting indicator from which to return results.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Output only.
      #
      # The List companies response object.
    "metadata": { # Output only. # Additional information for the API invocation, such as the request
        # tracking id.
        #
        # Additional information returned to client, such as debugging information.
      "requestId": "A String", # A unique id associated with this call.
          # This id is logged for tracking purposes.
    },
    "nextPageToken": "A String", # A token to retrieve the next page of results.
    "companies": [ # Companies for the current client.
      { # A Company resource represents a company in the service. A company is the
          # entity that owns job postings, that is, the hiring entity responsible for
          # employing applicants for the job position.
        "name": "A String", # 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}/companies/{company_id}", for example,
            # "projects/api-test-project/companies/foo".
        "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
        "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
          "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
              # Company.hq_location if provided.
              #
              # A resource that represents a location with full geographic information.
            "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
                # such as postal delivery and payments addresses. Given a postal address,
                # a postal service can deliver items to a premises, P.O. Box, or other
                # delivery location.
                # Given a postal address, a postal service can deliver items to a premise, P.O.
                # Box or similar.
                # It is not intended to model geographical locations (roads, towns,
                # mountains).
                #
                # In typical usage an address would be created via user input or from importing
                # existing data, depending on the type of process.
                #
                # Advice on address input / editing:
                #  - Use an i18n-ready address widget such as
                #    https://github.com/google/libaddressinput)
                # - Users should not be presented with UI elements for input or editing of
                #   fields outside countries where that field is used.
                #
                # For more guidance on how to use this schema, please see:
                # https://support.google.com/business/answer/6397478
              "organization": "A String", # Optional. The name of the organization at the address.
              "sublocality": "A String", # Optional. Sublocality of the address.
                  # For example, this can be neighborhoods, boroughs, districts.
              "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
                  # known). This is often the UI language of the input form or is expected
                  # to match one of the languages used in the address' country/region, or their
                  # transliterated equivalents.
                  # This can affect formatting in certain countries, but is not critical
                  # to the correctness of the data and will never affect any validation or
                  # other non-formatting related operations.
                  #
                  # If this value is not known, it should be omitted (rather than specifying a
                  # possibly incorrect default).
                  #
                  # Examples: "zh-Hant", "ja", "ja-Latn", "en".
              "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
                  # addresses of a country or region.
                  # For example, this can be a state, a province, an oblast, or a prefecture.
                  # Specifically, for Spain this is the province and not the autonomous
                  # community (e.g. "Barcelona" and not "Catalonia").
                  # Many countries don't use an administrative area in postal addresses. E.g.
                  # in Switzerland this should be left unpopulated.
              "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
                  # Examples: US city, IT comune, UK post town.
                  # In regions of the world where localities are not well defined or do not fit
                  # into this structure well, leave locality empty and use address_lines.
              "recipients": [ # Optional. The recipient at the address.
                  # This field may, under certain circumstances, contain multiline information.
                  # For example, it might contain "care of" information.
                "A String",
              ],
              "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
                  # the latest revision.
                  #
                  # All new revisions **must** be backward compatible with old revisions.
              "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
                  # postal codes to be present, but where they are used, they may trigger
                  # additional validation with other parts of the address (e.g. state/zip
                  # validation in the U.S.A.).
              "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
                  # in most regions. Where it is used, the value is either a string like
                  # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
                  # alone, representing the "sector code" (Jamaica), "delivery area indicator"
                  # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
              "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
                  # is never inferred and it is up to the user to ensure the value is
                  # correct. See http://cldr.unicode.org/ and
                  # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
                  # for details. Example: "CH" for Switzerland.
              "addressLines": [ # Unstructured address lines describing the lower levels of an address.
                  #
                  # Because values in address_lines do not have type information and may
                  # sometimes contain multiple values in a single field (e.g.
                  # "Austin, TX"), it is important that the line order is clear. The order of
                  # address lines should be "envelope order" for the country/region of the
                  # address. In places where this can vary (e.g. Japan), address_language is
                  # used to make it explicit (e.g. "ja" for large-to-small ordering and
                  # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
                  # an address can be selected based on the language.
                  #
                  # The minimum permitted structural representation of an address consists
                  # of a region_code with all remaining information placed in the
                  # address_lines. It would be possible to format such an address very
                  # approximately without geocoding, but no semantic reasoning could be
                  # made about any of the address components until it was at least
                  # partially resolved.
                  #
                  # Creating an address only containing a region_code and address_lines, and
                  # then geocoding is the recommended way to handle completely unstructured
                  # addresses (as opposed to guessing which parts of the address should be
                  # localities or administrative areas).
                "A String",
              ],
            },
            "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
                # location bounding box in which a circle with the specified radius
                # centered from LatLng covers the area associated with the job location.
                # For example, currently, "Mountain View, CA, USA" has a radius of
                # 6.17 miles.
            "locationType": "A String", # The type of a location, which corresponds to the address lines field of
                # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
                # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
                # LocationType#LOCALITY.
            "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
                # of doubles representing degrees latitude and degrees longitude. Unless
                # specified otherwise, this must conform to the
                # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
                # standard</a>. Values must be within normalized ranges.
              "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
              "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
            },
          },
        },
        "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
            # site, for example, "https://careers.google.com".
        "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
            # corresponding `string_values` are used in keyword search. Jobs with
            # `string_values` under these specified field keys are returned if any
            # of the values matches the search keyword. Custom field values with
            # parenthesis, brackets and special symbols won't be properly searchable,
            # and those keyword queries need to be surrounded by quotes.
          "A String",
        ],
        "size": "A String", # Optional. The employer's company size.
        "headquartersAddress": "A String", # Optional. 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.
        "suspended": True or False, # 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.
        "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
        "websiteUri": "A String", # Optional. 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.
        "eeoText": "A String", # Optional. 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.
        "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
            # company.
            #
            # The maximum number of allowed characters is 255.
        "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
            # employers.
            #
            # Defaults to false if not provided.
      },
    ],
  }
list_next(previous_request, previous_response)
Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.
    
patch(name, body=None, x__xgafv=None)
Updates specified company. Company names can't be updated. To update a
company name, delete the company and all jobs associated with it, and only
then re-create them.

Args:
  name: string, 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}/companies/{company_id}", for example,
"projects/api-test-project/companies/foo". (required)
  body: object, The request body.
    The object takes the form of:

{ # Input only.
      # 
      # Request for updating a specified company.
    "company": { # A Company resource represents a company in the service. A company is the # Required. The company resource to replace the current resource in the system.
        # entity that owns job postings, that is, the hiring entity responsible for
        # employing applicants for the job position.
      "name": "A String", # 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}/companies/{company_id}", for example,
          # "projects/api-test-project/companies/foo".
      "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
      "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
        "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
            # Company.hq_location if provided.
            #
            # A resource that represents a location with full geographic information.
          "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
              # such as postal delivery and payments addresses. Given a postal address,
              # a postal service can deliver items to a premises, P.O. Box, or other
              # delivery location.
              # Given a postal address, a postal service can deliver items to a premise, P.O.
              # Box or similar.
              # It is not intended to model geographical locations (roads, towns,
              # mountains).
              #
              # In typical usage an address would be created via user input or from importing
              # existing data, depending on the type of process.
              #
              # Advice on address input / editing:
              #  - Use an i18n-ready address widget such as
              #    https://github.com/google/libaddressinput)
              # - Users should not be presented with UI elements for input or editing of
              #   fields outside countries where that field is used.
              #
              # For more guidance on how to use this schema, please see:
              # https://support.google.com/business/answer/6397478
            "organization": "A String", # Optional. The name of the organization at the address.
            "sublocality": "A String", # Optional. Sublocality of the address.
                # For example, this can be neighborhoods, boroughs, districts.
            "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
                # known). This is often the UI language of the input form or is expected
                # to match one of the languages used in the address' country/region, or their
                # transliterated equivalents.
                # This can affect formatting in certain countries, but is not critical
                # to the correctness of the data and will never affect any validation or
                # other non-formatting related operations.
                #
                # If this value is not known, it should be omitted (rather than specifying a
                # possibly incorrect default).
                #
                # Examples: "zh-Hant", "ja", "ja-Latn", "en".
            "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
                # addresses of a country or region.
                # For example, this can be a state, a province, an oblast, or a prefecture.
                # Specifically, for Spain this is the province and not the autonomous
                # community (e.g. "Barcelona" and not "Catalonia").
                # Many countries don't use an administrative area in postal addresses. E.g.
                # in Switzerland this should be left unpopulated.
            "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
                # Examples: US city, IT comune, UK post town.
                # In regions of the world where localities are not well defined or do not fit
                # into this structure well, leave locality empty and use address_lines.
            "recipients": [ # Optional. The recipient at the address.
                # This field may, under certain circumstances, contain multiline information.
                # For example, it might contain "care of" information.
              "A String",
            ],
            "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
                # the latest revision.
                #
                # All new revisions **must** be backward compatible with old revisions.
            "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
                # postal codes to be present, but where they are used, they may trigger
                # additional validation with other parts of the address (e.g. state/zip
                # validation in the U.S.A.).
            "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
                # in most regions. Where it is used, the value is either a string like
                # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
                # alone, representing the "sector code" (Jamaica), "delivery area indicator"
                # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
            "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
                # is never inferred and it is up to the user to ensure the value is
                # correct. See http://cldr.unicode.org/ and
                # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
                # for details. Example: "CH" for Switzerland.
            "addressLines": [ # Unstructured address lines describing the lower levels of an address.
                #
                # Because values in address_lines do not have type information and may
                # sometimes contain multiple values in a single field (e.g.
                # "Austin, TX"), it is important that the line order is clear. The order of
                # address lines should be "envelope order" for the country/region of the
                # address. In places where this can vary (e.g. Japan), address_language is
                # used to make it explicit (e.g. "ja" for large-to-small ordering and
                # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
                # an address can be selected based on the language.
                #
                # The minimum permitted structural representation of an address consists
                # of a region_code with all remaining information placed in the
                # address_lines. It would be possible to format such an address very
                # approximately without geocoding, but no semantic reasoning could be
                # made about any of the address components until it was at least
                # partially resolved.
                #
                # Creating an address only containing a region_code and address_lines, and
                # then geocoding is the recommended way to handle completely unstructured
                # addresses (as opposed to guessing which parts of the address should be
                # localities or administrative areas).
              "A String",
            ],
          },
          "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
              # location bounding box in which a circle with the specified radius
              # centered from LatLng covers the area associated with the job location.
              # For example, currently, "Mountain View, CA, USA" has a radius of
              # 6.17 miles.
          "locationType": "A String", # The type of a location, which corresponds to the address lines field of
              # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
              # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
              # LocationType#LOCALITY.
          "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
              # of doubles representing degrees latitude and degrees longitude. Unless
              # specified otherwise, this must conform to the
              # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
              # standard</a>. Values must be within normalized ranges.
            "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
            "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
          },
        },
      },
      "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
          # site, for example, "https://careers.google.com".
      "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
          # corresponding `string_values` are used in keyword search. Jobs with
          # `string_values` under these specified field keys are returned if any
          # of the values matches the search keyword. Custom field values with
          # parenthesis, brackets and special symbols won't be properly searchable,
          # and those keyword queries need to be surrounded by quotes.
        "A String",
      ],
      "size": "A String", # Optional. The employer's company size.
      "headquartersAddress": "A String", # Optional. 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.
      "suspended": True or False, # 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.
      "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
      "websiteUri": "A String", # Optional. 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.
      "eeoText": "A String", # Optional. 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.
      "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
          # company.
          #
          # The maximum number of allowed characters is 255.
      "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
          # employers.
          #
          # Defaults to false if not provided.
    },
    "updateMask": "A String", # Optional but strongly recommended for the best service
        # experience.
        # 
        # If update_mask is provided, only the specified fields in
        # company are updated. Otherwise all the fields are updated.
        # 
        # A field mask to specify the company fields to be updated. Only
        # top level fields of Company are supported.
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A Company resource represents a company in the service. A company is the
      # entity that owns job postings, that is, the hiring entity responsible for
      # employing applicants for the job position.
    "name": "A String", # 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}/companies/{company_id}", for example,
        # "projects/api-test-project/companies/foo".
    "displayName": "A String", # Required. The display name of the company, for example, "Google LLC".
    "derivedInfo": { # Derived details about the company. # Output only. Derived details about the company.
      "headquartersLocation": { # Output only. # A structured headquarters location of the company, resolved from
          # Company.hq_location if provided.
          #
          # A resource that represents a location with full geographic information.
        "postalAddress": { # Represents a postal address, e.g. for postal delivery or payments addresses. # Postal address of the location that includes human readable information,
            # such as postal delivery and payments addresses. Given a postal address,
            # a postal service can deliver items to a premises, P.O. Box, or other
            # delivery location.
            # Given a postal address, a postal service can deliver items to a premise, P.O.
            # Box or similar.
            # It is not intended to model geographical locations (roads, towns,
            # mountains).
            #
            # In typical usage an address would be created via user input or from importing
            # existing data, depending on the type of process.
            #
            # Advice on address input / editing:
            #  - Use an i18n-ready address widget such as
            #    https://github.com/google/libaddressinput)
            # - Users should not be presented with UI elements for input or editing of
            #   fields outside countries where that field is used.
            #
            # For more guidance on how to use this schema, please see:
            # https://support.google.com/business/answer/6397478
          "organization": "A String", # Optional. The name of the organization at the address.
          "sublocality": "A String", # Optional. Sublocality of the address.
              # For example, this can be neighborhoods, boroughs, districts.
          "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if
              # known). This is often the UI language of the input form or is expected
              # to match one of the languages used in the address' country/region, or their
              # transliterated equivalents.
              # This can affect formatting in certain countries, but is not critical
              # to the correctness of the data and will never affect any validation or
              # other non-formatting related operations.
              #
              # If this value is not known, it should be omitted (rather than specifying a
              # possibly incorrect default).
              #
              # Examples: "zh-Hant", "ja", "ja-Latn", "en".
          "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal
              # addresses of a country or region.
              # For example, this can be a state, a province, an oblast, or a prefecture.
              # Specifically, for Spain this is the province and not the autonomous
              # community (e.g. "Barcelona" and not "Catalonia").
              # Many countries don't use an administrative area in postal addresses. E.g.
              # in Switzerland this should be left unpopulated.
          "locality": "A String", # Optional. Generally refers to the city/town portion of the address.
              # Examples: US city, IT comune, UK post town.
              # In regions of the world where localities are not well defined or do not fit
              # into this structure well, leave locality empty and use address_lines.
          "recipients": [ # Optional. The recipient at the address.
              # This field may, under certain circumstances, contain multiline information.
              # For example, it might contain "care of" information.
            "A String",
          ],
          "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is
              # the latest revision.
              #
              # All new revisions **must** be backward compatible with old revisions.
          "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require
              # postal codes to be present, but where they are used, they may trigger
              # additional validation with other parts of the address (e.g. state/zip
              # validation in the U.S.A.).
          "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used
              # in most regions. Where it is used, the value is either a string like
              # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
              # alone, representing the "sector code" (Jamaica), "delivery area indicator"
              # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
          "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This
              # is never inferred and it is up to the user to ensure the value is
              # correct. See http://cldr.unicode.org/ and
              # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
              # for details. Example: "CH" for Switzerland.
          "addressLines": [ # Unstructured address lines describing the lower levels of an address.
              #
              # Because values in address_lines do not have type information and may
              # sometimes contain multiple values in a single field (e.g.
              # "Austin, TX"), it is important that the line order is clear. The order of
              # address lines should be "envelope order" for the country/region of the
              # address. In places where this can vary (e.g. Japan), address_language is
              # used to make it explicit (e.g. "ja" for large-to-small ordering and
              # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
              # an address can be selected based on the language.
              #
              # The minimum permitted structural representation of an address consists
              # of a region_code with all remaining information placed in the
              # address_lines. It would be possible to format such an address very
              # approximately without geocoding, but no semantic reasoning could be
              # made about any of the address components until it was at least
              # partially resolved.
              #
              # Creating an address only containing a region_code and address_lines, and
              # then geocoding is the recommended way to handle completely unstructured
              # addresses (as opposed to guessing which parts of the address should be
              # localities or administrative areas).
            "A String",
          ],
        },
        "radiusInMiles": 3.14, # Radius in miles of the job location. This value is derived from the
            # location bounding box in which a circle with the specified radius
            # centered from LatLng covers the area associated with the job location.
            # For example, currently, "Mountain View, CA, USA" has a radius of
            # 6.17 miles.
        "locationType": "A String", # The type of a location, which corresponds to the address lines field of
            # PostalAddress. For example, "Downtown, Atlanta, GA, USA" has a type of
            # LocationType#NEIGHBORHOOD, and "Kansas City, KS, USA" has a type of
            # LocationType#LOCALITY.
        "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # An object representing a latitude/longitude pair.
            # of doubles representing degrees latitude and degrees longitude. Unless
            # specified otherwise, this must conform to the
            # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
            # standard</a>. Values must be within normalized ranges.
          "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
          "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
        },
      },
    },
    "careerSiteUri": "A String", # Optional. The URI to employer's career site or careers page on the employer's web
        # site, for example, "https://careers.google.com".
    "keywordSearchableJobCustomAttributes": [ # Optional. A list of keys of filterable Job.custom_attributes, whose
        # corresponding `string_values` are used in keyword search. Jobs with
        # `string_values` under these specified field keys are returned if any
        # of the values matches the search keyword. Custom field values with
        # parenthesis, brackets and special symbols won't be properly searchable,
        # and those keyword queries need to be surrounded by quotes.
      "A String",
    ],
    "size": "A String", # Optional. The employer's company size.
    "headquartersAddress": "A String", # Optional. 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.
    "suspended": True or False, # 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.
    "imageUri": "A String", # Optional. A URI that hosts the employer's company logo.
    "websiteUri": "A String", # Optional. 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.
    "eeoText": "A String", # Optional. 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.
    "externalId": "A String", # Required. Client side company identifier, used to uniquely identify the
        # company.
        #
        # The maximum number of allowed characters is 255.
    "hiringAgency": True or False, # Optional. Set to true if it is the hiring agency that post jobs for other
        # employers.
        #
        # Defaults to false if not provided.
  }