Job Update API エラーのトラブルシューティング

一般的な Job Update API エラーと、その解決方法を説明します。

 

エラーを検出する方法

Job Update API は、GraphQL レスポンスとしてエラーを返します。ほとんどのエラーは HTTP 200 を返し、エラーの詳細はレスポンスボディに含まれます。

HTTP 200 の場合でも、レスポンスボディの errors 配列を常に確認してください。

{
  "data": null,
  "errors": [{
    "message": "Error description",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

extensions.code フィールドには、エラーの種類が含まれます。たとえば、FORBIDDEN、BAD_USER_INPUT、NOT_FOUND があります。

FORBIDDEN エラー

FORBIDDEN error

code	FORBIDDEN
Summary	アクセストークンに、要求された操作を実行する権限がありません。具体的な原因は message フィールドに記載されます。

Advertiser is in a restricted moderation status

{
  "errors": [{
    "extensions": {
      "code": "FORBIDDEN",
      "message": "Advertiser is in a restricted moderation status"
    }
  }]
}

OAuth トークンに関連付けられている広告主は、スパム対策の措置として制限されています。

解決方法:

1. 制限を解除するため、パートナーマネージャーに連絡します。

You are missing permissions for this action

{
  "errors": [{
    "extensions": {
      "code": "FORBIDDEN",
      "message": "You are missing permissions for this action. Ask your administrator for the permissions [Hosted_Job Create, Hosted_Job Update, Hosted_Job Read]"
    }
  }]
}

OAuth トークンに関連付けられているユーザーには、求人を更新するために必要な権限がありません。

解決方法:

1. OAuth クライアントが管理者ユーザーによって作成されたことを確認します。
2. OAuth クライアントに関連付けられているユーザーに、Hosted_Job Create、Hosted_Job Update、Hosted_Job Read の権限を付与します。この権限は任意の管理者ユーザーが付与できます。Indeed account settings を参照してください。

Advertiser is requesting an update to a job claimed by a different advertiser

{
  "errors": [{
    "extensions": {
      "code": "FORBIDDEN",
      "message": "Advertiser is requesting an update to EJ (id=<EJID>), but the job is claimed by a different advertiser."
    }
  }]
}

この求人は、すでに別の広告主によって更新されています。1 つの求人を同時に更新できる広告主は 1 つだけです。

解決方法:

1. OAuth トークンが正しい広告主でリクエストされていることを確認します。
2. 別の広告主が求人を更新した場合は、clear job posting updates ミューテーションを使用します。

このエラーは、次の場合に発生することがあります。

• 代理店が複数の広告主からその求人へのアクセス権を持っています。1 つの広告主から求人を更新した後に、別の広告主から更新すると、このエラーが発生します。
• 雇用主が UI でその求人を編集しました。代理店が API を通じて求人を更新する前に、雇用主は UI でその編集を元に戻す必要があります。

UNAUTHENTICATED エラー

UNAUTHENTICATED error

code	UNAUTHENTICATED
Summary	OAuth トークンの有効期限が切れているか、形式が正しくありません。

{
  "errors": [{
    "extensions": {
      "code": "UNAUTHENTICATED"
    }
  }]
}

解決方法:

1. OAuth トークンの有効期限が切れていないことを確認します。トークンの有効期間は 1 時間です。
2. 新しいアクセストークンをリクエストします。
3. 詳細な解決手順については、Troubleshoot OAuth errors を参照してください。

BAD_USER_INPUT エラー

BAD_USER_INPUT error

code	BAD_USER_INPUT
Summary	リクエストの形式が正しくありません。詳細は message フィールドを確認してください。

{
  "errors": [{
    "extensions": {
      "code": "BAD_USER_INPUT"
    }
  }]
}

解決方法:

1. message フィールドで、どのフィールドが無効かを確認します。
2. リクエストの各フィールドが正しい形式であることを確認します。
3. 正しい形式のリクエスト例については、次の API リファレンスを参照してください。
   • findEmployerJobsPartner
   • updateSourcedJobPostings
   • clearSourcedJobPostingUpdates

NOT_FOUND エラー

NOT_FOUND error

code	NOT_FOUND
Summary	求人が見つかりません。

{
  "errors": [{
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

解決方法:

1. sourcedPostingId が正しいことを確認します。
2. OAuth トークンが正しい広告主でリクエストされていることを確認します。リクエスト元の広告主にその求人を表示する権限がない場合も、このエラーが発生します。

DOWNSTREAM_SERVICE_ERROR または INTERNAL_SERVER_ERROR

DOWNSTREAM_SERVICE_ERROR

code	DOWNSTREAM_SERVICE_ERROR or INTERNAL_SERVER_ERROR
Summary	サーバー内部でエラーが発生しました。

{
  "errors": [{
    "extensions": {
      "code": "DOWNSTREAM_SERVICE_ERROR"
    }
  }]
}

解決方法:

1. しばらく待ってからリクエストを再試行します。
2. エラーが継続する場合は、パートナーマネージャーに連絡します。

Retry strategy

Retryable errors

Error	Retryable?	Strategy
DOWNSTREAM_SERVICE_ERROR	Yes	Exponential backoff
INTERNAL_SERVER_ERROR	Yes	Exponential backoff
UNAUTHENTICATED (expired token)	Yes	Refresh token, then retry once
FORBIDDEN	No	Fix permissions
BAD_USER_INPUT	No	Fix the request
NOT_FOUND	No	Verify the sourcedPostingId and advertiser

サポートを受ける

このガイドに記載されていない問題が発生した場合:

1. GraphQL エラーの message と extensions オブジェクトを確認します。
2. 必須フィールドがすべて存在し、正しい形式であることを確認します。
3. まず最小限の入力でテストし、その後でフィールドを段階的に追加します。
4. Indeed 担当者に連絡します。

関連情報:

• GraphQL エラーのトラブルシューティング
• OAuth エラーのトラブルシューティング
• レート制限

 

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