2025-08-21
GraphQLスキーマおよびGraphQL APIリファレンスを次の変更内容で更新しました：
Send Candidates API
破壊的変更(14)
破壊的変更
- オブジェクトタイプ
AtsSyncCandidateSyncApplicationVersionStatusからフィールドatsApplicationIdを削除しました。 - オブジェクトタイプ
AtsSyncCandidateSyncApplicationVersionStatusからフィールドatsCandidateIdを削除しました。 - オブジェクトタイプ
AtsSyncCandidateSyncApplicationVersionStatusからフィールドindeedRegistrationIdを削除しました。 - オブジェクトタイプ
AtsSyncCandidateSyncApplicationVersionStatusからフィールドjobMetadataを削除しました。 - 入力オブジェクトタイプ
DeleteAtsSyncCandidateSyncApplicationInputにタイプAtsSyncCandidateSyncApplicationIdentifierInput!の入力フィールドapplicationIdentifierを追加しました。 - 入力オブジェクトタイプ
DeleteAtsSyncCandidateSyncApplicationInputから入力フィールドatsApplicationIdを削除しました。 - 入力オブジェクトタイプ
DeleteAtsSyncCandidateSyncApplicationInputから入力フィールドatsCandidateIdを削除しました。 - 入力オブジェクトタイプ
DeleteAtsSyncCandidateSyncApplicationInputから入力フィールドindeedRegistrationIdを削除しました。 - 入力オブジェクトタイプ
DeleteAtsSyncCandidateSyncApplicationInputから入力フィールドjobMetadataを削除しました。 - 入力オブジェクトタイプ
InitializeAtsSyncCandidateSyncApplicationInputにタイプAtsSyncCandidateSyncApplicationIdentifierInput!の入力フィールドapplicationIdentifierを追加しました。 - 入力オブジェクトタイプ
InitializeAtsSyncCandidateSyncApplicationInputから入力フィールドatsApplicationIdを削除しました。 - 入力オブジェクトタイプ
InitializeAtsSyncCandidateSyncApplicationInputから入力フィールドatsCandidateIdを削除しました。 - 入力オブジェクトタイプ
InitializeAtsSyncCandidateSyncApplicationInputから入力フィールドindeedRegistrationIdを削除しました。 - 入力オブジェクトタイプ
InitializeAtsSyncCandidateSyncApplicationInputから入力フィールドjobMetadataを削除しました。
新機能(2)
新機能
- タイプ
AtsSyncCandidateSyncApplicationIdentifierを追加しました。 - オブジェクトタイプ
AtsSyncCandidateSyncApplicationVersionStatusにフィールドapplicationIdentifierを追加しました。
採用企業データAPI
ドキュメント(36)
ドキュメント
- フィールド
AttributeUpdateError.detailの説明を変更しました。[削除: Detail that helps understand][追加: Details about] the error. - フィールド
AttributeUpdateError.messageの説明を変更しました。A short message [追加: that ]describes the error.[削除: ] - フィールド
AttributeUpdateError.suggestionの説明を変更しました。Suggestion[削除: that helps][追加: to help] recover from the error. - タイプ
AttributeUpdateResponseCodeの説明を変更しました。Standard GraphQL error code[削除: described in API Recommendations][追加: that MUST report standardized error codes for commonly encountered errors [229] describes.] - enum値
AttributeUpdateResponseCode.BAD_USER_INPUTの説明を変更しました。The value of an input parameter is invalid. This error code applies to input validation performed beyond the standard GraphQL client and server libraries[削除: Non-Null][追加: non-null] and type checking. - enum値
AttributeUpdateResponseCode.FORBIDDENの説明を変更しました。Valid authentication credentials are present but insufficient to perform the associated operation. This error code is the GraphQL equivalent of the HTTP [追加: `403 Forbidden` ]response status[削除: 403 Forbidden][追加: code]. - enum値
AttributeUpdateResponseCode.INTERNAL_SERVER_ERRORの説明を変更しました。The server encountered an unexpected failure and did not provide a response. Use this generic error[削除: only ]for failures that the server cannot handle. - enum値
AttributeUpdateResponseCode.PARTIAL_SUCCESSの説明を変更しました。[削除: Its partial-success][追加: Partial-success] if the response contains only part of successful response because of some failures. - enum値
AttributeUpdateResponseCode.UNAUTHENTICATEDの説明を変更しました。The operation was not attempted because the request did not include sufficient authentication credentials for the operation. This error code is the GraphQL equivalent of the HTTP [追加: `401 Unauthorized` ]response status[削除: 401 Unauthorized][追加: code]. - 入力フィールド
CountrySpecificEmployerAttributesInput.countryの説明を変更しました。An ISO 3166-1 - alpha[削除: 2 encoded][追加: 2-encoded] country code string,[削除: e.g. US][追加: such as],[削除: JP][追加: `US` or `JP`]. - 入力フィールド
CountrySpecificEmployerAttributesInput.employeesの説明を変更しました。[削除: The size][追加: Size] of the employers workforce. Allowed values[追加: are]:[削除: - ERv1_1][追加: | Value | Number of employees | |]:[追加: ------------------|--------------------:| | `ERv1_1` | ]1[削除: employee - ERv1_2_10: 2-10 employees - ERv1_11_50: 11-50 employees - ERv1_1_50: 1-50 employees - ERv1_51_200: 51-200 employees - ERv1_201_500: 201-500 employees - ERv1_501_1000: 501-1000 employees - ERv1_1001_5000: 1001-5000 employees - ERv1_5001_10000: 5001-10000 employees - ERv1_10000_PLUS: ][追加: | | `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[削除: is supposed to be used as][追加: the] global default, set[削除: isGlobalDefault=true][追加: `isGlobalDefault=true`]. If[削除: isGlobalDefault=true is set, beside][追加: `isGlobalDefault=true` in addition to] its normal locale, data[削除: will][追加: is] also[削除: be ]written to[削除: ww_WW][追加: `ww_WW`] internally. This field is deprecated because it[削除: will][追加: is] always[削除: be true][追加: `true`] for[削除: CountrySpecificEmployerAttributes][追加: `CountrySpecificEmployerAttributes`]. - 入力フィールド
CountrySpecificEmployerAttributesInput.phoneNumの説明を変更しました。[削除: Official Phone Number of the employer][追加: Deprecated].[削除: This field is deprecated, please use phoneNumber][追加: Employers official phone number. Use the `phoneNumber`] field instead. - 入力フィールド
CountrySpecificEmployerAttributesInput.phoneNumberの説明を変更しました。[削除: Official Phone Number of ][追加: Employers official phone number. The value must follow ]the[削除: employer][追加: standard [E].[追加: 164](https://en.wikipedia.org/wiki/E.164) format. For example, `+17895551234`.] - 入力フィールド
CountrySpecificEmployerAttributesInput.sectorSUIDsの説明を変更しました。[削除: A list][追加: List] of Indeed sector (industry) [追加: short unique identifiers (]SUIDs[追加: )]. [追加: The maximum number of SUIDs is 3. ]Each value must be a valid[削除: SUID—see the following][追加: SUID. See this] table[削除: .][追加: :] **Market-specific documentation**[削除: |Market|Guidance| |-|-| |Japan|[Valid ][追加: | Market | Example value | |:-------|:--------------| | Japan | [Valid ]company sector SUID values](https://docs.indeed.[削除: com/employer/reference/company-sector][追加: com/indeed-plus/employer-data-api/reference/company-sector])[削除: | ][追加: . |] - 入力フィールド
CountrySpecificEmployerAttributesInput.taxIdの説明を変更しました。[削除: Tax identifier of the employer][追加: Employers tax identifier].[削除: Limited to][追加: Limit is] 100[削除: chars][追加: characters]. **Market-specific documentation**[削除: |Market|Example value| |-|-| |Japan|Use the 法人番号. ][追加: | Market | Example value | |:-------|:--------------| | Japan | ]If[削除: `employerType=JURIDICAL_PERSON`, fill in ][追加: [`employerType`](/api/employer/objects/EmployerAttributesInput) is `JURIDICAL_PERSON`, set ]this field[削除: with 法 人番号 whenever possible. It is necessary][追加: to the corporate number (法人番号)] to correctly identify[削除: a][追加: the] company.[削除: If `employerType=NATURAL_PERSON`][追加: <br/><br/>If `employerType` is `NATURAL_PERSON`], this field is optional.[削除: | ][追加: |] - 入力フィールド
CountrySpecificEmployerAttributesInput.websiteUrlの説明を変更しました。The root website of the[削除: employer&mdash][追加: `employer`&mdash];for example, `indeed.com`. If the employer is a franchise, use the brand website.[削除: Limited to][追加: Limit is] 400[削除: chars][追加: characters]. Must be a valid URL.[削除: ] - タイプ
EmployerAttributesInputの説明を変更しました。[削除: Each attribute in this input type is an][追加: Input object that contains] employer[削除: attribute][追加: attributes] that[削除: can be updated on type EmployerAttributesInput][追加: you can update.] - 入力フィールド
EmployerAttributesInput.countrySpecificAttributesの説明を変更しました。Employer attributes that can[削除: be different based on the][追加: differ by] country. - 入力フィールド
EmployerAttributesInput.employerTypeの説明を変更しました。[削除: Type of the employer][追加: Employer type].[削除: **Market-Specific][追加: **Market-specific] documentation**[削除: |Market|Example value| |-|-| |Japan|Use ][追加: | Market | Example value | |:-------|:--------------| | Japan | Use ]the field to specify 企業区分: 法人 or[削除: 個人|][追加: 個人. |] - 入力フィールド
EmployerAttributesInput.localeSpecificAttributesの説明を変更しました。Employer attributes that can[削除: be different based on the][追加: differ by] locale ([削除: lang][追加: `lang`] +[削除: country][追加: `country`]). - 入力フィールド
JpNewGradsEmployerAttributesInput.schoolsWithHiringRecordsの説明を変更しました。A list of schools[削除: where ][追加: from which ]the employer has previously hired graduates[削除: from]. Each school name must be[削除: less][追加: fewer] than 100 characters, and the total number of schools cannot exceed 1000. - 入力フィールド
LocaleSpecificEmployerAttributesInput.countryの説明を変更しました。An ISO 3166-1[削除: - ]alpha[削除: 2 encoded][追加: 2-encoded] country code[削除: string][追加: string—for example],[削除: e.g. 'US', 'JP'][追加: `US` or `JP`].[削除: We do][追加: `ww_WW` is] not[削除: accept ww_WW][追加: accepted] for worldwide default data. All data must set a valid[削除: country/language][追加: country and language]. - 入力フィールド
LocaleSpecificEmployerAttributesInput.languageの説明を変更しました。An ISO 639-1 - alpha[削除: 2 encoded][追加: 2-encoded] language code[削除: string][追加: string—for example],[削除: e.g. 'en', 'ja'][追加: `en` or `ja`].[削除: We do][追加: `ww_WW` is] not[削除: accept ww_WW][追加: accepted] for worldwide default data. All data must set a valid[削除: country/language][追加: country and language]. - 入力フィールド
LocaleSpecificEmployerAttributesInput.isGlobalDefaultの説明を変更しました。If[削除: the data is supposed to be used][追加: `true`, defines the data] as [追加: the ]global default[削除: , set isGlobalDefault=true]. - 入力フィールド
LocaleSpecificEmployerAttributesInput.localizedNameの説明を変更しました。Employer name in the[削除: given ]locale. Length[削除: must be 1-60 chars][追加: 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|Google| |localizedName|グーグル ][追加: | Field | Example value | |:----------------|:-----------------------| | `name` | Yamada Kyujin | | `localizedName` | 山田求人 ](ja_JP)[追加: ]|[削除: |phoneticName|グーグル ][追加: | `phoneticName` | ヤマダキュウジン ](ja_JP)[追加: ]|[削除: |Field|Example value| |-|-| |name|Rakuten| |localizedName|楽天 ][追加: | Field | Example value | |:----------------|:-----------------------| | `name` | Google | | `localizedName` | グーグル ](ja_JP)[追加: ]|[削除: |phoneticName|ラクテン ][追加: | `phoneticName` | グーグル ](ja_JP)[追加: ]|[追加: | Field | Example value | |:----------------|:-----------------------| | `name` | Rakuten | | `localizedName` | 楽天 (ja_JP) | | `phoneticName` | ラクテン (ja_JP) |] - 入力フィールド
LocaleSpecificEmployerAttributesInput.phoneticNameの説明を変更しました。Phonetic name of the employer. [追加: Limit is 250 characters. ]**Examples**[削除: |Field|Example value| |-|-| |name|Google| |localizedName|グーグル ][追加: | Field | Example value | |:----------------|:-----------------------| | `name` | Yamada Kyujin | | `localizedName` | 山田求人 ](ja_JP)[追加: ]|[削除: |phoneticName|グーグル ][追加: | `phoneticName` | ヤマダキュウジン ](ja_JP)[追加: ]|[削除: |Field|Example value| |-|-| |name|Rakuten| |localizedName|楽天 ][追加: | Field | Example value | |:----------------|:-----------------------| | `name` | Google | | `localizedName` | グーグル ](ja_JP)[追加: ]|[削除: |phoneticName|ラクテン ][追加: | `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[削除: the following][追加: these] dimensions: * **Minimum**: 256x256 pixels * **Maximum**: 4096x4096 pixels - フィールド
Mutation.patchEmployerの説明を変更しました。[削除: Submit employer information. - If employer identifiers cannot be resolved to existing Indeed employerKey, it may create a new one. The created employer will not be claimed. To claim it, use another API. - If employer identifiers were resolved into existing Indeed employerKey, API will PARTIALLY update the employer, where only provided fields will be updated. Other fields will not be touched. Return affected employerKey for accepted request. Depending on the client type, some Indeed employer will be marked as "protected". You can only update: - Non-protected Indeed employer - Protected Indeed employer created by the same client You will not be able to touch protected Indeed employer created by other clients. In such cases, "FORBIDDEN" will be returned. ][追加: Creates or updates an employer. * If Indeed resolves `input.id` to an employer, it updates the specified fields for that employer. * If Indeed cannot resolve `input.id` to an employer, it creates an employer. If the request succeeds, the API returns the `employerKey` for the updated or new employer. Depending on the client type, some Indeed employers are marked as *protected*. You can update only: - Non-protected Indeed employers - Protected Indeed employers created by the same client You cannot update protected Indeed employers that other clients created. If you try to do so, the API returns the `FORBIDDEN` error. When you call the Indeed PLUS APIs, initiate a timeout after 5,000 milliseconds.] - タイプ
PatchEmployerInputの説明を変更しました。[削除: To partial update employer attributes, - {websiteUrl: <not provided>}, nothing will be updated. - {websiteUrl: null}, the attribute will be removed. - {websiteUrl: "http://example.com"}, websiteUrl will be overwritten. For array type of fields, eg. sectorSUIDs. - {sectorSUIDs: <not provided>}, nothing will be updated. - {sectorSUIDs: null}, all existing values will be removed. - {sectorSUIDs: [<some-values>]}, all existing values will be overwritten. Example request (examples for other type of clients are not exposed in this public doc) ``` { "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" } ] }, "createEmployerIfNotFound": true } ``` ][追加: 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" }] } } ```] - 入力フィールド
PatchEmployerInput.idの説明を変更しました。The[削除: the ]globally unique [追加: Internationalized Resource Identifier (]IRI[追加: )] for [追加: the ]employer. - 入力フィールド
PatchEmployerInput.employerNameの説明を変更しました。Official employer name[削除: . It's ][追加: , which is ]required to create[削除: a new][追加: an] Indeed employer key, and optional to submit employer data.[追加: Limit is 255 UTF-16-encoded characters. Cannot include the email address or eight consecutive digits. :::note The value of `employerName` is copied to the **global** [`localizedName`](/api/employer/objects/LocaleSpecificEmployerAttributesInput) field, except when the request explicitly sets the **global** [`localizedName`](/api/employer/objects/LocaleSpecificEmployerAttributesInput) field. :::] - 入力フィールド
PatchEmployerInput.employerAttributesの説明を変更しました。Employer attributes to[削除: be updated][追加: update]. If[削除: this is set ]null, no employer attributes[削除: will be][追加: are] updated. - タイプ
PatchEmployerPayloadの説明を変更しました。Response for[削除: patchEmployer][追加: `patchEmployer`]. - フィールド
PatchEmployerPayload.attributeUpdatedの説明を変更しました。[削除: Returns][追加: If] `true`[削除: if][追加: ,] the employer attribute[削除: has been][追加: was] updated,[削除: and][追加: . Otherwise,] `false`[削除: otherwise]. - フィールド
PatchEmployerPayload.errorsの説明を変更しました。[削除: A list][追加: List] of errors.[削除: Empty array will be returned if there is no error][追加: If no errors occur, returns an empty array].
共通
破壊的変更(4)
破壊的変更
- オブジェクトタイプ
JobLocationからフィールドadmin1Codeを削除しました。 - オブジェクトタイプ
JobLocationからフィールドadmin2Codeを削除しました。 - オブジェクトタイプ
JobLocationからフィールドadmin3Codeを削除しました。 - オブジェクトタイプ
JobLocationからフィールドadmin4Codeを削除しました。
新機能(1)
新機能
- オブジェクトタイプ
EmployerJobExternalPostingMetadataにフィールドrawInputLocationを追加しました。
ドキュメント(3)
ドキュメント
- タイプ
EmployerIdentifiersInputの説明を変更しました。Employer identifier that uniquely defines an employer. Clients that have Indeed employer key[削除: .][追加: :] ``` { "type": "INDEED_EMPLOYER", "id": "<Indeed employerKey>" } ``` Other types of employer[削除: identifier types will be][追加: identifiers are] communicated **individually**[削除: ]. - 入力フィールド
EmployerIdentifiersInput.typeの説明を変更しました。A magic string that indicates the identifier type. - Otherwise, the type[削除: will be][追加: is] communicated individually. - 入力フィールド
EmployerIdentifiersInput.idの説明を変更しました。ID[追加: .]