2026-01-12

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

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

[log] ✔ フィールド AttributeUpdateError.detail の説明が次から：
```
Details about the error. 
```
次のように変更されました：
```
Error details.
```
[log] ✔ フィールド 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.
```
[log] ✔ フィールド AttributeUpdateError.message description が次から：
```
A short message that describes the error.
```
次のように変更されました：
```
Short error message.
```
[log] ✔ フィールド 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.
```
[log] ✔ フィールド AttributeUpdateError.suggestion の説明が次から：
```
Suggestion to help recover from the error. 
```
次のように変更されました：
```
Recovery suggestion.
```
[log] ✔ フィールド 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.
```

[log] ✔ タイプ 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.

Has changed to:

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

[log] ✔ 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.

[log] ✔ 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`.

[log] ✔ 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.

[log] ✔ 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.
```
[log] ✔ enum 値 AttributeUpdateResponseCode.QUERY_TOO_COMPLEX の説明が次から：
```
The query exceeded the allowed complexity for a single request.
```
次のように変更されました：
```
Query exceeded complexity limit.
```

[log] ✔ 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`.

[log] ✔ タイプ CountrySpecificEmployerAttributesInput の説明：
```
Country specific data
```
Has changed to:
```
Country-specific data.
```
[log] ✔ 入力フィールド 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`).
```

[log] ✔ 入力フィールド 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    |

[log] ✔ 入力フィールド 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.

[log] ✔ 入力フィールド CountrySpecificEmployerAttributesInput.phoneNum の説明が次から：
```
Deprecated. Employers official phone number. Use the `phoneNumber` field instead. 
```
次のように変更されました：
```
Deprecated. Use `phoneNumber` instead.'
```

[log] ✔ 入力フィールド 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`

[log] ✔ 入力フィールド 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).

[log] ✔ 入力フィールド 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.   

[log] ✔ 入力フィールド 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.'

[log] ✔ タイプ EmployerAttributesInput の説明：
```
Input object that contains employer attributes that you can update.
```
Has changed to:
```
Updatable employer attributes.
```
[log] ✔ 入力フィールド EmployerAttributesInput.countrySpecificAttributes の説明が次から：
```
Employer attributes that can differ by country. 
```
次のように変更されました：
```
Country-specific employer attributes.
```
[log] ✔ 入力フィールド EmployerAttributesInput.jpNewGradsAttributes の説明が次から：
```
Employer attributes that are specific to JP New-Grads. 
```
次のように変更されました：
```
JP new grads employer attributes.
```
[log] ✔ 入力フィールド EmployerAttributesInput.localeSpecificAttributes の説明が次から：
```
Employer attributes that can differ by locale (`lang` + `country`). 
```
次のように変更されました：
```
Locale-specific employer attributes (`lang` + `country`).
```

[log] ✔ タイプ EmployerIdentifiersInput の説明：

Employer identifier that uniquely defines an employer.

Clients that have Indeed employer key:

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

Has changed to:

Unique employer identifier.

For clients with an Indeed employer key:

Other identifier types are communicated individually.

[log] ✔ 入力フィールド 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.

[log] ✔ タイプ JpNewGradsEmployerAttributesInput の説明：
```
Employer attributes that are specific to JP New-Grads
```
Has changed to:
```
JP new grads employer attributes.
```

[log] ✔ 入力フィールド 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.

[log] ✔ タイプ LeaderInput の説明：
```
Leaders information.
```
Has changed to:
```
Leader information.
```
[log] ✔ 入力フィールド LeaderInput.name の説明が次から：
```
Leaders name 
```
次のように変更されました：
```
Leader name.
```
[log] ✔ タイプ LocaleSpecificEmployerAttributesInput の説明：
```
Attributes that are bound to specific locales
```
Has changed to:
```
Locale-specific attributes.
```

[log] ✔ 入力フィールド 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.

[log] ✔ 入力フィールド LocaleSpecificEmployerAttributesInput.description の説明が次から：
```
Description of the employer. 
```
次のように変更されました：
```
Employer description.
```
[log] ✔ 入力フィールド LocaleSpecificEmployerAttributesInput.headquarterAddress の説明が次から：
```
Headquarter address. Referenced as 本社所在地住所 in Japans market. 
```
次のように変更されました：
```
Headquarters address. Japan: 本社所在地住所
```
[log] ✔ 入力フィールド LocaleSpecificEmployerAttributesInput.isGlobalDefault の説明が次から：
```
If `true`, defines the data as the global default.  
```
次のように変更されました：
```
If `true`, sets this data as the global default.
```

[log] ✔ 入力フィールド 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.

[log] ✔ 入力フィールド LocaleSpecificEmployerAttributesInput.leader の説明が次から：
```
Leaders information. 
```
次のように変更されました：
```
Leader information.
```

[log] ✔ 入力フィールド 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)        |

[log] ✔ 入力フィールド 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)        |

[log] ✔ 入力フィールド 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

[log] ✔ フィールド 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.

[log] ✔ 説明：

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
    }]
  }
}

[log] ✔ 入力フィールド PatchEmployerInput.employerAttributes の説明が次から：
```
Employer attributes to update. If null, no employer attributes are updated. 
```
次のように変更されました：
```
Employer attributes to update. If null, nothing is updated.
```

[log] ✔ 入力フィールド 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.
::: 

[log] ✔ 入力フィールド PatchEmployerInput.id の説明が次から：
```
The globally unique Internationalized Resource Identifier (IRI) for the employer. 
```
次のように変更されました：
```
Globally unique IRI for the employer.
```
[log] ✔ フィールド PatchEmployerPayload.attributeUpdated の説明が次から：
```
If `true`, the employer attribute was updated,. Otherwise, `false`. 
```
次のように変更されました：
```
`true` if employer attributes were updated.
```
[log] ✔ フィールド PatchEmployerPayload.errors description が次から：
```
List of errors.

If no errors occur, returns an empty array. 
```
次のように変更されました：
```
List of errors. Empty if none.
```
[log] ✔ フィールド 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.
```

[log] ✔ フィールド 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