「ステータスの変更方法」

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

目的

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>