関連候補者の取得
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
目的
このメソッドを使用すると、外部のアプリケーションから、求人に関連付けられている候補者のデータを取得できます。
リクエストURL
XMLフォーマット。
https://recruit.zoho.com/recruit/private/xml/JobOpenings/getAssociatedCandidates?authtoken=AuthToken&scope=recruitapi&version=2
JSONフォーマット。
https://recruit.zoho.com/recruit/private/json/JobOpenings/getAssociatedCandidates?authtoken=AuthToken&scope=recruitapi&version=2
OAuth認証の場合
| ヘッダー名 |
値 |
| Authorization |
Zoho-oauthtoken {access_token} |
スコープ
Scope=ZohoRecruit.modules.all
（または）
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
| 使用可能なスコープ名（大文字と小文字を区別） |
操作の種類 |
|
candidate
|
ALL - データへのすべての権限 READ - タブからデータを取得 |
認証トークンによる認証の場合
| パラメーター |
データの種類 |
詳細 |
| authtoken* |
文字列 |
Zohoの認証情報を認証するための暗号化済みの英数字の文字列です。 |
| scope* |
文字列 |
次の値を指定します：recruitapi |
リクエストパラメーター
| パラメーター | データの種類 | 詳細 |
| id* | 文字列 | 求人データの一意のIDを指定します。 |
| version* | 整数 | 「version=2」を使用します：最新のAPI実装に基づいてレスポンスを取得します。 |
メモ：*が付いているパラメーターは必須です。
例
外部のアプリケーションを使用してZoho Recruitで求人を関連付ける場合。
レスポンス形式：
<response uri='/recruit/private/xml/JobOpenings/getAssociatedCandidates'>
<result>
<JobOpenings>
<row no='1'>
<FL val='CANDIDATEID'>50000000033009</FL>
<FL val='STATUS'>クライアントにより承認済み</FL>
</row>
<row no='2'>
<FL val='CANDIDATEID'>50000000027047</FL>
<FL val='STATUS'>評価待ち</FL>
</row>
<row no='3'>
<FL val='CANDIDATEID'>50000000035946</FL>
<FL val='STATUS'>評価待ち</FL>
</row>
<row no='4'>
<FL val='CANDIDATEID'>50000000036036</FL>
<FL val='STATUS'>クライアントにより承認済み</FL>
</row>
</JobOpenings>
</result>
</response>
<result>
<JobOpenings>
<row no='1'>
<FL val='CANDIDATEID'>50000000033009</FL>
<FL val='STATUS'>クライアントにより承認済み</FL>
</row>
<row no='2'>
<FL val='CANDIDATEID'>50000000027047</FL>
<FL val='STATUS'>評価待ち</FL>
</row>
<row no='3'>
<FL val='CANDIDATEID'>50000000035946</FL>
<FL val='STATUS'>評価待ち</FL>
</row>
<row no='4'>
<FL val='CANDIDATEID'>50000000036036</FL>
<FL val='STATUS'>クライアントにより承認済み</FL>
</row>
</JobOpenings>
</result>
</response>