2026-01-12

GraphQLスキーマ変更ログ: 2026-01-12

📘 ドキュメント： GraphQLスキーマおよびGraphQL APIリファレンスを次の変更内容で更新しました：

フィールド AttributeUpdateError.detail の説明を変更しました。変更前：
```
Details about the error. 
```
変更後：
```
Error details.
```
フィールド AttributeUpdateError.detail の説明を変更しました。変更前：
```
In case of error, the error information will be in the standard GraphQL errors array
```
変更後：
```
Errors appear in the standard GraphQL errors array.
```
フィールド AttributeUpdateError.message の説明を変更しました。変更前：
```
A short message that describes the error.
```
変更後：
```
Short error message.
```
フィールド AttributeUpdateError.message の説明を変更しました。変更前：
```
In case of error, the error information will be in the standard GraphQL errors array
```
変更後：
```
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 in the standard GraphQL errors array 
```
変更後：
```
Errors appear in the standard GraphQL errors array.
```

タイプ AttributeUpdateResponseCode の説明を変更しました。変更前：

Standard GraphQL error code that [MUST report standardized error codes for commonly encountered errors [229]](https://api-wg.pages.corp.indeed.com/api-recommendations/recommendations/graphql/errors/errors/#must-report-standardized-error-codes-for-commonly-encountered-errors-229) describes.

変更後：

Standard GraphQL error code. See [MUST report standardized error codes for commonly encountered errors [229]](https://api-wg.pages.corp.indeed.com/api-recommendations/recommendations/graphql/errors/errors/#must-report-standardized-error-codes-for-commonly-encountered-errors-229).

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 and type checking. 

変更後：

Invalid input parameter. Applies to validation beyond standard GraphQL type/`null` 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 code.

変更後：

Valid credentials but insufficient permissions. Equivalent to HTTP `403 Forbidden`.

enum値 AttributeUpdateResponseCode.INTERNAL_SERVER_ERROR の説明を変更しました。変更前：

The server encountered an unexpected failure and did not provide a response.

Use this generic error for failures that the server cannot handle.

変更後：

Unexpected server failure. Generic error for unhandled failures.

enum値 AttributeUpdateResponseCode.PARTIAL_SUCCESS の説明を変更しました。変更前：
```
Partial-success if the response contains only part of successful response because of some failures. 
```
変更後：
```
Partial success due to some failures.
```
enum値 AttributeUpdateResponseCode.QUERY_TOO_COMPLEX の説明を変更しました。変更前：
```
The query exceeded the allowed complexity for a single request.
```
変更後：
```
Query exceeded complexity limit.
```

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 code. 

変更後：

Insufficient authentication credentials. Equivalent to HTTP `401 Unauthorized`.

タイプ CountrySpecificEmployerAttributesInput の説明を変更しました。変更前：
```
Country specific data
```
変更後：
```
Country-specific data.
```
入力フィールド CountrySpecificEmployerAttributesInput.country の説明を変更しました。変更前：
```
An ISO 3166-1 - alpha 2-encoded country code string, such as, `US` or `JP`. 
```
変更後：
```
ISO 3166-1 alpha-2 country code (such as `US`, `JP`).
```

入力フィールド CountrySpecificEmployerAttributesInput.employees の説明を変更しました。変更前：

Size of the employers workforce.

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    | 

変更後：

Employers workforce size. Allowed values:

| 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`.
If `isGlobalDefault=true` in addition to its normal locale, data is also written to `ww_WW` internally.
This field is deprecated because it is always `true` for `CountrySpecificEmployerAttributes`. 

変更後：

Deprecated. Always `true` for `CountrySpecificEmployerAttributes`.
When `true`, data is also written to `ww_WW` internally.

入力フィールド CountrySpecificEmployerAttributesInput.phoneNum の説明を変更しました。変更前：
```
Deprecated. Employers official phone number. Use the `phoneNumber` field instead. 
```
変更後：
```
Deprecated. Use `phoneNumber` instead.
```

入力フィールド CountrySpecificEmployerAttributesInput.phoneNumber の説明を変更しました。変更前：

Employers official phone number.

The value must follow the standard [E.164](https://en.wikipedia.org/wiki/E.164) format. 

For example, `+17895551234`. 

変更後：

Employers official phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format. 

Example: `+17895551234`

入力フィールド CountrySpecificEmployerAttributesInput.sectorSUIDs の説明を変更しました。変更前：

List of Indeed sector (industry) short unique identifiers (SUIDs). 

The maximum number of SUIDs is 3. Each value must be a valid SUID. 

See this table:

**Market-specific documentation**

| Market | Example value |
|:-------|:--------------|
| Japan  | [Valid company sector SUID values](https://docs.indeed.com/employers/reference/company-sector). | 

変更後：

Sector (industry) SUIDs. Maximum 3, must be valid.

Japan: [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.<br/><br/>If `employerType` is `NATURAL_PERSON`, this field is optional. |   

変更後：

Employers tax identifier. Limit: 100 characters.

Japan: If [`employerType`](/api/employer/objects/EmployerAttributesInput) is `JURIDICAL_PERSON`, set to the corporate number (法人番号) for correct identification. If `employerType` is `NATURAL_PERSON`, this field is optional.   

入力フィールド CountrySpecificEmployerAttributesInput.websiteUrl の説明を変更しました。変更前：

The root website of the `employer`&mdash;for example, `indeed.com`.
If the employer is a franchise, use the brand website.

Limit is 400 characters. Must be a valid URL. 

変更後：

Employers root website (such as `indeed.com`). For franchises, use the brand website.

Limits: 400 characters. Must be a valid URL.

タイプ EmployerAttributesInput の説明を変更しました。変更前：
```
Input object that contains employer attributes that you can update.
```
変更後：
```
Updatable employer attributes.
```
入力フィールド 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 (`lang` + `country`). 
```
変更後：
```
Locale-specific employer attributes (`lang` + `country`).
```

タイプ EmployerIdentifiersInput の説明を変更しました。変更前：

Employer identifier that uniquely defines an employer.

Clients that have Indeed employer key:

Other types of employer identifiers are communicated **individually**.

変更後：

Unique employer identifier.

For clients with an Indeed employer key:

Other identifier types are communicated individually.

入力フィールド EmployerIdentifiersInput.type の説明を変更しました。変更前：

A magic string that indicates the identifier type.

- Indeed internal clients can check valid types on [`EmployerIdentifierType`](https://link.indeed.tech/cd-patch-employer).
- Otherwise, the type is communicated individually. 

変更後：

Identifier type.

* Indeed internal clients: See valid types in [`EmployerIdentifierType`](https://link.indeed.tech/cd-patch-employer).
* Others: Communicated individually.

タイプ JpNewGradsEmployerAttributesInput の説明を変更しました。変更前：
```
Employer attributes that are specific to JP New-Grads
```
変更後：
```
JP new grads employer attributes.
```

入力フィールド JpNewGradsEmployerAttributesInput.schoolsWithHiringRecords の説明を変更しました。変更前：

A list of schools from which the employer has previously hired graduates.
Each school name must be fewer than 100 characters, and the total number of schools cannot exceed 1000.

変更後：

Schools the employer has hired graduates from.

Limits: Max 1000 schools, each name under 100 characters.

タイプ LeaderInput の説明を変更しました。変更前：
```
Leaders information.
```
変更後：
```
Leader information.
```
入力フィールド LeaderInput.name の説明を変更しました。変更前：
```
Leaders name 
```
変更後：
```
Leader name.
```
タイプ LocaleSpecificEmployerAttributesInput の説明を変更しました。変更前：
```
Attributes that are bound to specific locales
```
変更後：
```
Locale-specific attributes.
```

入力フィールド LocaleSpecificEmployerAttributesInput.country の説明を変更しました。変更前：

An ISO 3166-1 alpha 2-encoded country code string&mdash;for example, `US` or `JP`.

`ww_WW` is not accepted for worldwide default data. All data must set a valid country and language. 

変更後：

ISO 3166-1 alpha-2 country code (such as `US`, `JP`).

`ww_WW` is not accepted. All data must specify a valid country and language.

入力フィールド LocaleSpecificEmployerAttributesInput.description の説明を変更しました。変更前：
```
Description of the employer. 
```
変更後：
```
Employer description.
```
入力フィールド LocaleSpecificEmployerAttributesInput.headquarterAddress の説明を変更しました。変更前：
```
Headquarter address. Referenced as 本社所在地住所 in Japans market. 
```
変更後：
```
Headquarters address. Japan: 本社所在地住所
```
入力フィールド LocaleSpecificEmployerAttributesInput.isGlobalDefault の説明を変更しました。変更前：
```
If `true`, defines the data as the global default.  
```
変更後：
```
If `true`, sets this data as the global default.
```

入力フィールド LocaleSpecificEmployerAttributesInput.language の説明を変更しました。変更前：

An ISO 639-1 - alpha 2-encoded language code string&mdash;for example, `en` or `ja`.

`ww_WW` is not accepted for worldwide default data. All data must set a valid country and language. 

変更後：

ISO 639-1 alpha-2 language code (such as `en`, `ja`).

`ww_WW` is not accepted. All data must specify a valid country and language.

入力フィールド LocaleSpecificEmployerAttributesInput.leader の説明を変更しました。変更前：
```
Leaders information. 
```
変更後：
```
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.

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)        |

変更後：

Employer phonetic name. Limit: 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:

* **Minimum**: 256x256 pixels
* **Maximum**: 4096x4096 pixels

変更後：

Base64-encoded square logo. 

Dimensions: 

* Minimum: 256×256 pixels
* Maximum: 4096×4096 pixels

フィールド Mutation.patchEmployer の説明を変更しました。変更前：

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.

変更後：

Creates or updates an employer.

If `input.id` matches an existing employer, updates it.

Otherwise, creates an employer.

Returns the `employerKey` on success.

**Protected employers:**

Some employers are marked as protected. You can only update:

* Non-protected employers
* Protected employers your client created

Updating a protected employer created by another client returns a `FORBIDDEN` error.

**Timeout:**

Set a 5,000 ms timeout for Indeed PLUS API calls.

説明を変更しました。変更前：

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&mdash;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
    }]
  }
}

入力フィールド PatchEmployerInput.employerAttributes の説明を変更しました。変更前：
```
Employer attributes to update. If null, no employer attributes are updated. 
```
変更後：
```
Employer attributes to update. If null, nothing is updated.
```

入力フィールド PatchEmployerInput.employerName の説明を変更しました。変更前：

Official employer name, which is required to create 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.
:::  

変更後：

Official employer name. Required to create an employer key; optional for submitting employer data.

Limits: 255 UTF-16 characters. No email addresses or 8+ consecutive digits.

:::note
`employerName` is copied to the global [`localizedName`](/api/employer/objects/LocaleSpecificEmployerAttributesInput) field unless explicitly set in the request.
::: 

入力フィールド PatchEmployerInput.id の説明を変更しました。変更前：
```
The globally unique Internationalized Resource Identifier (IRI) for the employer. 
```
変更後：
```
Globally unique IRI for the employer.
```
フィールド PatchEmployerPayload.attributeUpdated の説明を変更しました。変更前：
```
If `true`, the employer attribute was updated,. Otherwise, `false`. 
```
変更後：
```
`true` if employer attributes were updated.
```
フィールド PatchEmployerPayload.errors の説明を変更しました。変更前：
```
List of errors.

If no errors occur, returns an empty array. 
```
変更後：
```
List of errors. Empty if none.
```
フィールド PatchEmployerPayload.errors の説明を変更しました。変更前：
```
In case of error, the error information will be in the standard GraphQL errors array 
```
変更後：
```
Errors appear in the standard GraphQL errors array.
```

フィールド PatchEmployerPayload.responseCode の説明を変更しました。変更前：

In case of success, no special response code will be used. In case of error, the error codes will be in the standard GraphQL errors array

変更後：

Success returns no special code. Errors appear in the standard GraphQL errors array.

GraphQLスキーマ変更ログ: 2026-01-12​

このページは役に立ちましたか？

GraphQLスキーマ変更ログ: 2026-01-12