「ステータスの変更方法」
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
目的
Zoho Recruitのジョブオープニングに関して、候補者ステータスを変更するためにこの方法を使用することができます。
注意： 代わりにGETメソッドを使用して、これらのパラメータを渡す場合はPOSTメソッドを使用してください。
リクエストURL
XML形式:
https://recruit.zoho.com/recruit/private/xml/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi
JSON形式:
https://recruit.zoho.com/recruit/private/json/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi
XML形式:
https://recruit.zoho.com/recruit/private/xml/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi
JSON形式:
https://recruit.zoho.com/recruit/private/json/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi
OAuth 認証について
| ヘッダー名 | 値 |
| 承認 | Zoho-oauthtoken {access_token} |
範囲
スコープ=ZohoRecruit.モジュール.すべて
(または)
スコープ=ZohoRecruit.モジュール.{スコープ名}.{操作タイプ}
| 可能なスコープ名（大文字小文字を区別） | 操作タイプ |
| 候補者ステータス、求人オープンステータス、インタビューステータス | ALL - レコードへの完全なアクセス READ - モジュールからレコードを取得 |
認証トークン認証について
| パラメータ | データ型 | 説明 |
| authtoken* | String | 暗号化された英数字の文字列を使用して、Zohoの資格情報を認証します。 |
| 範囲* | 文字列 | 値を指定してください recruitapi |
リクエストパラメータ
| パラメータ | データ型 | 説明 |
| jobId | String | ジョブオープニングレコードの固有のIDを指定してください 関連する候補者のステータスを変更したい場合。 ジョブオープニングに関連する候補者のステータスを変更したい場合、このパラメーターは必須です。 |
| 候補者ID* | 文字列 | カンマで区切られた候補者IDを指定してください。それらのステータスを、求人に関して変更する必要があります。. |
| バージョン* | 整数 | 使用 version=2: これにより、最新のAPI実装に基づいた応答が取得されます |
| 候補者ステータス* | String | 候補者のステータスを指定してください 求人開設に関して。 |
| コメント | 文字列 | ステータスの変更に関するコメントを指定してください。 |
注意： *でマークされたパラメーターは必須です。
例
求職者に関する求人のステータスを変更する。
URL 形式:
https://recruit.zoho.com/recruit/private/xml/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi&jobId=54290000000089027&
candidateIds=54290000000022332,54290000000089027&
candidateStatus=Hired&comments='Placed in Java Development'&lock=true
URL 形式:
https://recruit.zoho.com/recruit/private/xml/Candidates/changeStatus?authtoken=AuthToken&scope=recruitapi&jobId=54290000000089027&
candidateIds=54290000000022332,54290000000089027&
candidateStatus=Hired&comments='Javaの開発に配置'&lock=true
レスポンス形式：
<response uri='/recruit/private/xml/Candidates/changeStatus'>
<result>
<message>候補者のステータスが正常に変更されました</message>
<recorddetail>
<FL val='jobId'> 292114000000087156</FL>
<FL val='candidateStatus'>Hired</FL><FL val='comments'> Java開発に配置されました</FL>
</recorddetail>
</result>
</response>
<result>
<message>候補者のステータスが正常に変更されました</message>
<recorddetail>
<FL val='jobId'> 292114000000087156</FL>
<FL val='candidateStatus'>Hired</FL><FL val='comments'> Java開発に配置されました</FL>
</recorddetail>
</result>
</response>