ステータスの変更

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

目的

このメソッドを使用して、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

OAuth認証の場合

ヘッダー名	値
Authorization	Zoho-oauthtoken {access_token}

スコープ

Scope=ZohoRecruit.modules.all

（または）

Scope=ZohoRecruit.modules.{scope_name}.{operation_type}

使用可能なスコープ名（大文字と小文字を区別）	操作の種類
candidatestatus, jobopeningstatus, interviewstatus	ALL - データへのすべての権限 READ - タブからデータを取得

認証トークン認証の場合

パラメーター	データの種類	詳細
authtoken*	文字列	Zoho認証情報を認証するための暗号化された英数字の文字列です。
scope*	文字列	値にはrecruitapiを指定します

リクエストパラメーター

パラメーター	データ型	詳細
jobId	文字列	関連付けられている候補者のステータスを変更する対象の求人データの一意のIDを指定します。求人に関連付けられている候補者のステータスを変更する場合、このパラメーターは必須です。
candidateIds*	文字列	求人に関してステータスを変更する候補者IDを、コンマ区切りで指定します。
version*	整数	「version=2」を使用します。これにより、最新のAPI実装に基づいてレスポンスを取得します
candidateStatus*	文字列	求人に関する候補者のステータスを指定します。
comments	文字列	ステータス変更に関するコメントを指定します。

メモ：*が付いているパラメーターは必須です。

例

求人に関して候補者のステータスを変更する場合の例です。

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

レスポンス形式：

<response uri='/recruit/private/xml/Candidates/changeStatus'>
<result>
<message>Candidate(s) status changed successfully</message>
<recorddetail>
<FL val='jobId'> 292114000000087156</FL>
<FL val='candidateStatus'>Hired</FL><FL val='comments'> Placed in Java Development</FL>
</recorddetail>
</result>
</response>