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 エラー

code	FORBIDDEN
概要	アクセストークンに、要求された操作を実行する権限がありません。具体的な原因は 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 ミューテーションを使用します。

このエラーは次の場合に発生する可能性があります。

• 代理店が複数の広告主を通じて同じ求人にアクセスできる場合。
• 雇用主が UI で求人を編集しており、代理店が API で更新する前にその編集を元に戻す必要がある場合。

UNAUTHENTICATED エラー

UNAUTHENTICATED エラー

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

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

解決するには:

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

BAD_USER_INPUT エラー

BAD_USER_INPUT エラー

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

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

解決するには:

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

NOT_FOUND エラー

NOT_FOUND エラー

code	NOT_FOUND
概要	求人が見つかりませんでした。

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

解決するには:

1. sourcedPostingId が正しいことを確認します。
2. OAuth トークンが正しい広告主に対してリクエストされたことを確認します。

リクエスト元の広告主にその求人を表示する権限がない場合にも、このエラーが発生することがあります。

DOWNSTREAM_SERVICE_ERROR または INTERNAL_SERVER_ERROR

DOWNSTREAM_SERVICE_ERROR

code	DOWNSTREAM_SERVICE_ERROR または INTERNAL_SERVER_ERROR
概要	内部サーバーエラーが発生しました。

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

解決するには:

1. しばらくしてからリクエストを再試行します。
2. エラーが続く場合は、パートナーマネージャーにお問い合わせください。

再試行戦略

再試行可能なエラー

エラー	再試行可能か	方針
DOWNSTREAM_SERVICE_ERROR	はい	指数バックオフを使用
INTERNAL_SERVER_ERROR	はい	指数バックオフを使用
UNAUTHENTICATED（トークンの期限切れ）	はい	トークンを更新してから 1 回再試行
FORBIDDEN	いいえ	権限の問題を解消
BAD_USER_INPUT	いいえ	リクエストを修正
NOT_FOUND	いいえ	sourcedPostingId と広告主を確認

サポートを受ける

このガイドで扱っていない問題が発生した場合:

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

関連項目:

• Troubleshoot GraphQL errors
• Troubleshoot OAuth errors
• Error reference

 

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