候補者評価の変更

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

目的

このメソッドを使用して、Zoho Recruitで求人に対する候補者の評価を変更できます。

メモ：これらのパラメーターを渡すには、GETメソッドではなくPOSTメソッドを使用してください。

リクエストURL

XMLフォーマット。

https://recruit.zoho.com/recruit/private/xml/Candidates/changeCandidateRating?authtoken=AuthToken&scope=recruitapi&jobId=54290000000089027&candidateIds=54290000000022332,54290000000089027&rating=5.0&comments=Well Performed

JSONフォーマット。

https://recruit.zoho.com/recruit/private/json/Candidates/changeCandidateRating?authtoken=AuthToken&scope=recruitapi&jobId=54290000000089027&candidateIds=54290000000022332,54290000000089027&rating=5.0&comments=Well Performed

OAuth認証の場合

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

スコープ

Scope=ZohoRecruit.modules.all

（または）

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

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

Authtoken認証の場合

パラメーター	データ型	詳細
authtoken*	文字列	Zoho認証情報を認証するための暗号化済みの英数字文字列です。
scope*	文字列	値として recruitapi を指定します

リクエストパラメーター

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

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

例

求人に対する候補者の評価を変更します。

URLフォーマット：

レスポンス形式：

<response uri='/recruit/private/xml/Candidates/changeCandidateRating'>
<result>
<Candidates>
<message>Rating updated successfully</message>
<recorddetail>
<FL val='CANDIDATEID'>2179000001594148</FL>
</recorddetail>
</Candidates>
</result>
</response>