2026-01-12
GraphQLスキーマおよびGraphQL APIリファレンスを次の変更内容で更新しました：
採用企業データAPI
ドキュメント(48)
ドキュメント
- フィールド
AttributeUpdateError.detailの説明を変更しました。[削除: Details about the error][追加: Error details].[削除: ] - フィールド
AttributeUpdateError.detailの説明を変更しました。[削除: In case of error, the error information will be][追加: Errors appear] in the standard GraphQL errors array[追加: .] - フィールド
AttributeUpdateError.messageの説明を変更しました。[削除: A short][追加: Short error] message[削除: that describes the error]. - フィールド
AttributeUpdateError.messageの説明を変更しました。[削除: In case of error, the error information will be][追加: Errors appear] in the standard GraphQL errors array[追加: .] - フィールド
AttributeUpdateError.suggestionの説明を変更しました。[削除: Suggestion to help recover from the error][追加: Recovery suggestion].[削除: ] - フィールド
AttributeUpdateError.suggestionの説明を変更しました。[削除: In case of error, the error information will be][追加: Errors appear] in the standard GraphQL errors array[削除: ][追加: .] - タイプ
AttributeUpdateResponseCodeの説明を変更しました。Standard GraphQL error code[削除: that][追加: . See] MUST report standardized error codes for commonly encountered errors [229][削除: describes]. - enum値
AttributeUpdateResponseCode.BAD_USER_INPUTの説明を変更しました。[削除: The value of an][追加: Invalid] input parameter[削除: is invalid].[削除: This error code applies][追加: Applies] to[削除: input ]validation[削除: performed ]beyond[削除: the ]standard GraphQL[削除: client and server libraries non-null and type][追加: type/`null`] checking.[削除: ] - enum値
AttributeUpdateResponseCode.FORBIDDENの説明を変更しました。Valid[削除: authentication ]credentials[削除: are present ]but insufficient[削除: to perform the associated operation][追加: permissions].[削除: This error code is the GraphQL equivalent of the][追加: Equivalent to] HTTP `403 Forbidden`[削除: response status code]. - enum値
AttributeUpdateResponseCode.INTERNAL_SERVER_ERRORの説明を変更しました。[削除: The][追加: Unexpected] server[削除: encountered an unexpected ]failure[削除: and did not provide a response].[削除: Use this generic][追加: Generic] error for[削除: failures that the server cannot handle][追加: unhandled failures]. - enum値
AttributeUpdateResponseCode.PARTIAL_SUCCESSの説明を変更しました。[削除: Partial-success if the response contains only part of successful response because of][追加: Partial success due to] some failures.[削除: ] - enum値
AttributeUpdateResponseCode.QUERY_TOO_COMPLEXの説明を変更しました。[削除: The query][追加: Query] exceeded[削除: the allowed ]complexity[削除: for a single request][追加: limit]. - enum値
AttributeUpdateResponseCode.UNAUTHENTICATEDの説明を変更しました。[削除: The operation was not attempted because the request did not include sufficient][追加: Insufficient] authentication credentials[削除: for the operation].[削除: This error code is the GraphQL equivalent of the][追加: Equivalent to] HTTP `401 Unauthorized`[削除: response status code].[削除: ] - タイプ
CountrySpecificEmployerAttributesInputの説明を変更しました。[削除: Country specific][追加: Country-specific] data[追加: .] - 入力フィールド
CountrySpecificEmployerAttributesInput.countryの説明を変更しました。[削除: An ]ISO 3166-1[削除: - alpha 2-encoded][追加: alpha-2] country code[削除: string, ][追加: (]such as[削除: ,]`US`[削除: or][追加: ,] `JP`[追加: )].[削除: ] - 入力フィールド
CountrySpecificEmployerAttributesInput.employeesの説明を変更しました。[削除: Size of the employers][追加: Employers] workforce[追加: size]. Allowed values[削除: are]: | Value | Number of employees | |:------------------|--------------------:| | `ERv1_1` | 1 | | `ERv1_2_10` | From 2 to 10 | | `ERv1_11_50` | From 11 to 50 | | `ERv1_1_50` | From 1 to 50 | | `ERv1_51_200` | From 51 to 200 | | `ERv1_201_500` | From 201 to 500 | | `ERv1_501_1000` | From 501 to 1000 | | `ERv1_1001_5000` | From 1001 to 5000 | | `ERv1_5001_10000` | From 5001 to 10000 | | `ERv1_10000_PLUS` | 10000+ employees |[削除: ] - 入力フィールド
CountrySpecificEmployerAttributesInput.isGlobalDefaultの説明を変更しました。Deprecated.[削除: If the data the global default, set `isGlobalDefault=true`][追加: Always `true` for `CountrySpecificEmployerAttributes`].[削除: If `isGlobalDefault=true` in addition to its normal locale][追加: When `true`], data is also written to `ww_WW` internally.[削除: This field is deprecated because it is always `true` for `CountrySpecificEmployerAttributes`. ] - 入力フィールド
CountrySpecificEmployerAttributesInput.phoneNumの説明を変更しました。Deprecated.[削除: Employers official phone number. ]Use[削除: the ]`phoneNumber`[削除: field ]instead.[削除: ] - 入力フィールド
CountrySpecificEmployerAttributesInput.phoneNumberの説明を変更しました。Employers official phone number[削除: . The value must follow the standard][追加: in] [E.164](https://en.wikipedia.org/wiki/E.164) format.[削除: For example,][追加: Example:] `+17895551234`[削除: . ] - 入力フィールド
CountrySpecificEmployerAttributesInput.sectorSUIDsの説明を変更しました。[削除: List of Indeed sector][追加: Sector] (industry)[削除: short unique identifiers (]SUIDs[削除: )].[削除: The maximum number of SUIDs is][追加: Maximum] 3[削除: . Each value][追加: ,] must be[削除: a ]valid[削除: SUID].[削除: See this table: **Market-specific documentation** | Market | Example value | |:-------|:--------------| | ]Japan[削除: | [Valid company sector SUID values]][追加: : [Company sectors]](https://docs.indeed.com/employers/reference/company-sector).[削除: | ] - 入力フィールド
CountrySpecificEmployerAttributesInput.taxIdの説明を変更しました。Employers tax identifier. Limit[削除: is][追加: :] 100 characters.[削除: **Market-specific documentation** | Market | Example value | |:-------|:--------------| | ]Japan[削除: |][追加: :] If [`employerType`](/api/employer/objects/EmployerAttributesInput) is `JURIDICAL_PERSON`, set[削除: this field ]to the corporate number (法人番号)[削除: to correctly identify the company][追加: for correct identification].[削除: <br/><br/>If ][追加: If ]`employerType` is `NATURAL_PERSON`, this field is optional.[削除: | ] - 入力フィールド
CountrySpecificEmployerAttributesInput.websiteUrlの説明を変更しました。[削除: The][追加: Employers] root website[削除: of the `employer`—for example,][追加: (such as] `indeed.com`[追加: )].[削除: If the employer is a franchise][追加: For franchises], use the brand website.[削除: Limit is][追加: Limits:] 400 characters. Must be a valid URL.[削除: ] - タイプ
EmployerAttributesInputの説明を変更しました。[削除: Input object that contains][追加: Updatable] employer attributes[削除: that you can update]. - 入力フィールド
EmployerAttributesInput.countrySpecificAttributesの説明を変更しました。[削除: Employer attributes that can differ by country][追加: Country-specific employer attributes].[削除: ] - 入力フィールド
EmployerAttributesInput.jpNewGradsAttributesの説明を変更しました。[削除: Employer attributes that are specific to JP New-Grads][追加: JP new grads employer attributes].[削除: ] - 入力フィールド
EmployerAttributesInput.localeSpecificAttributesの説明を変更しました。[削除: Employer attributes that can differ by locale][追加: Locale-specific employer attributes] (`lang` + `country`).[削除: ] - タイプ
JpNewGradsEmployerAttributesInputの説明を変更しました。[削除: Employer attributes that are specific to JP New-Grads][追加: JP new grads employer attributes.] - 入力フィールド
JpNewGradsEmployerAttributesInput.schoolsWithHiringRecordsの説明を変更しました。[削除: A list of schools from which][追加: Schools] the employer has[削除: previously ]hired graduates[追加: from].[削除: Each school name must be fewer than][追加: Limits: Max 1000 schools, each name under] 100 characters[削 除: , and the total number of schools cannot exceed 1000].[削除: ] - タイプ
LeaderInputの説明を変更しました。[削除: Leaders][追加: Leader] information. - 入力フィールド
LeaderInput.nameの説明を変更しました。[削除: Leaders][追加: Leader] name[削除: ][追加: .] - タイプ
LocaleSpecificEmployerAttributesInputの説明を変更しました。[削除: Attributes that are bound to specific locales][追加: Locale-specific attributes.] - 入力フィールド
LocaleSpecificEmployerAttributesInput.countryの説明を変更しました。[削除: An ]ISO 3166-1[削除: alpha 2-encoded][追加: alpha-2] country code[削除: string—for example,][追加: (such as] `US`[削除: or][追加: ,] `JP`[追加: )]. `ww_WW` is not accepted[削除: for worldwide default data]. All data must[削除: set][追加: specify] a valid country and language.[削除: ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.descriptionの説明を変更しました。[削除: Description of the employer][追加: Employer description].[削除: ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.headquarterAddressの説明を変更しました。[削除: Headquarter][追加: Headquarters] address.[削除: Referenced as][追加: Japan:] 本社所在地住所[削除: in Japans market. ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.isGlobalDefaultの説明を変更しました。If `true`,[削除: defines the][追加: sets this] data as the global default.[削除: ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.languageの説明を変更しました。[削除: An ]ISO 639-1[削除: - alpha 2-encoded][追加: alpha-2] language code[削除: string—for example,][追加: (such as] `en`[削除: or][追加: ,] `ja`[追加: )]. `ww_WW` is not accepted[削除: for worldwide default data]. All data must[削除: set][追加: specify] a valid country and language.[削除: ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.leaderの説明を変更しました。[削除: Leaders][追加: Leader] information.[削除: ] - 入力フィールド
LocaleSpecificEmployerAttributesInput.localizedNameの説明を変更しました。[削除: Employer name in the locale. Length is from 1 to 60 characters. :::note If the request uses the `Ignore` operation to omit this field but provides `employerName`, then the global `localizedName` field is set to the [`employerName`](/api/employer/objects/PatchEmployerInput) field value. ::: **Examples** | Field | Example value | |:----------------|:-----------------------| | `name` | Yamada Kyujin | | `localizedName` | 山田求人 (ja_JP) | | `phoneticName` | ヤマダキュウジン (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Google | | `localizedName` | グーグル (ja_JP) | | `phoneticName` | グーグル (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Rakuten | | `localizedName` | 楽天 (ja_JP) | | `phoneticName` | ラクテン (ja_JP) | ][追加: Localized employer name. Limit: 1 to 60 characters. :::note If the request uses the `Ignore` operation to omit this field but provides `employerName`, then the global `localizedName` field is set to the [`employerName`](/api/employer/objects/PatchEmployerInput) field value. ::: **Examples**: | Field | Example value | |:----------------|:-----------------------| | `name` | Yamada Kyujin | | `localizedName` | 山田求人 (ja_JP) | | `phoneticName` | ヤマダキュウジン (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Google | | `localizedName` | グーグル (ja_JP) | | `phoneticName` | グーグル (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Rakuten | | `localizedName` | 楽天 (ja_JP) | | `phoneticName` | ラクテン (ja_JP) |] - 入力フィールド
LocaleSpecificEmployerAttributesInput.phoneticNameの説明を変更しました。[削除: Phonetic name of the employer][追加: Employer phonetic name]. Limit[削除: is][追加: :] 250 characters. **Examples**[追加: :] | Field | Example value | |:----------------|:-----------------------| | `name` | Yamada Kyujin | | `localizedName` | 山田求人 (ja_JP) | | `phoneticName` | ヤマダキュウジン (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Google | | `localizedName` | グーグル (ja_JP) | | `phoneticName` | グーグル (ja_JP) | | Field | Example value | |:----------------|:-----------------------| | `name` | Rakuten | | `localizedName` | 楽天 (ja_JP) | | `phoneticName` | ラクテン (ja_JP) | - 入力フィールド
LocaleSpecificEmployerAttributesInput.squareLogoの説明を変更しました。Base64-encoded square logo.[削除: Must be a square image with these dimensions][追加: Dimensions]: *[削除: **Minimum**][追加: Minimum]:[削除: 256x256][追加: 256×256] pixels *[削除: **Maximum**][追加: Maximum]:[削除: 4096x4096][追加: 4096×4096] pixels - フィールド
Mutation.patchEmployerの説明を変更しました。Creates or updates an employer.[削除: * ]If[削除: Indeed resolves ]`input.id`[削除: to][追加: matches] an [追加: existing ]employer,[削除: it ]updates[削除: the specified fields for that employer. * If Indeed cannot resolve `input][追加: it].[削除: id` to an employer][追加: Otherwise],[削除: it ]creates an employer.[削除: If the request succeeds, the API returns][追加: Returns] the `employerKey`[削除: for the updated or new employer. Depending ]on[削除: the client type, some Indeed][追加: success. **Protected employers:** Some] employers are marked as[削除: *protected*][追加: protected]. You can[削除: update ]only[追加: update]:[削除: -][追加: *] Non-protected[削除: Indeed ]employers[削除: -][追加: *] Protected[削除: Indeed ]employers[削除: created by the same][追加: your] client[削除: You cannot update][追加: created Updating a] protected[削除: Indeed employers that other clients][追加: employer] created[削除: . If you try to do so, the API][追加: by another client] returns[削除: the][追加: a] `FORBIDDEN` error.[削除: When you call the Indeed PLUS APIs][追加: **Timeout:** Set a 5],[削除: initiate a][追加: 000 ms] timeout[削除: after 5,000 milliseconds. ][追加: for Indeed PLUS API calls.] - 入力フィールド
PatchEmployerInput.employerAttributesの説明を変更しました。Employer attributes to update. If null,[削除: no employer attributes are][追加: nothing is] updated.[削除: ] - 入力フィールド
PatchEmployerInput.employerNameの説明を変更しました。Official employer name[削除: , which is required][追加: . Required] to create an[削除: Indeed ]employer key[削除: , and][追加: ;] optional[削除: to submit][追加: for submitting] employer data.[削除: Limit is][追加: Limits:] 255[削除: UTF-16-encoded][追加: UTF-16] characters.[削除: Cannot include the][追加: No] email[削除: address][追加: addresses] or[削除: eight][追加: 8+] consecutive digits. :::note[削除: The value of ]`employerName` is copied to the[削除: **global**][追加: global] [`localizedName`](/api/employer/objects/LocaleSpecificEmployerAttributesInput) field[削 除: , except when the request][追加: unless] explicitly[削除: sets the **global** [`localizedName`](/api/employer/objects/LocaleSpecificEmployerAttributesInput) field][追加: set in the request]. ::: - 入力フィールド
PatchEmployerInput.idの説明を変更しました。[削除: The globally][追加: Globally] unique[削除: Internationalized Resource Identifier (]IRI[削除: )]for the employer.[削除: ] - フィールド
PatchEmployerPayload.attributeUpdatedの説明を変更しました。[削除: If ]`true`[削除: , the][追加: if] employer[削除: attribute was][追加: attributes were] updated[削除: ,].[削除: Otherwise, `false`. ] - フィールド
PatchEmployerPayload.errorsの説明を変更しました。List of errors.[削除: If no errors occur, returns an empty array][追加: Empty if none].[削除: ] - フィールド
PatchEmployerPayload.errorsの説明を変更しました。[削除: In case of error, the error information will be][追加: Errors appear] in the standard GraphQL errors array[削除: ][追加: .] - フィールド
PatchEmployerPayload.responseCodeの説明を変更しました。[削除: In case of success,][追加: Success returns] no special[削除: response ]code[削除: will be used].[削除: In case of error, the error codes will be][追加: Errors appear] in the standard GraphQL errors array[削除: ][追加: .]
共通
ドキュメント(3)
ドキュメント
- タイプ
EmployerIdentifiersInputの説明を変更しました。[削除: Employer ][追加: Unique employer ]identifier[削除: that uniquely defines][追加: . For clients with] an[削除: employer. Clients that have ]Indeed employer key: Other[削除: types of employer identifiers][追加: identifier types] are communicated[削除: **individually**][追加: individually]. - 入力フィールド
EmployerIdentifiersInput.typeの説明を変更しました。[削除: A magic string that indicates the identifier][追加: Identifier] type.[削除: - Otherwise, the type is communicated][追加: * Others: Communicated] individually.[削除: ] - タイプ
PatchEmployerInputの説明を変更しました。[削除: To partially update employer attributes: * `{websiteUrl: <not-provided>}`: Does not update the attribute. * `{websiteUrl: null}`: Removes the attribute. * `{websiteUrl: http://example.com}`: Overwrites the attribute with the specified value. For fields that are array types—for example, `sectorSUIDs`: * `{sectorSUIDs: <not-provided>}`: Does not update the attribute. * `{sectorSUIDs: []}`: Removes the attribute. * `{sectorSUIDs: [<some-values>]}`: Overwrites the attribute with the specified values. An example request is: { id: { type: INDEED_EMPLOYER_KEY, id: Employer key }, employerName: Example company, employerAttributes: { countrySpecificAttributes: [{ country: US, sectorSUIDs: [SUID - of - some - indeed - sector] }], localeSpecificAttributes: [{ country: US, language: en, isGlobalDefault: true, description: Description of example company, squareLogo: Base64 - encoded - string }] } } ][追加: | Action | Regular fields | Array fields | |:--------|:---------------|:-------------| | Keep unchanged | Omit the field | Omit the field | | Remove value | Set to null | Set to `[]` | | Overwrite | Set new value | Set new array | **Example**: { id: { type: INDEED_EMPLOYER_KEY, id: Employer key }, employerName: Example company, employerAttributes: { countrySpecificAttributes: [{ country: US, sectorSUIDs: [SUID - of - some - indeed - sector] }], localeSpecificAttributes: [{ country: US, language: en, isGlobalDefault: true, description: Description of example company, squareLogo: Base64 - encoded - string }] } }]