求人の関連付け

求人の関連付け

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

目的

このメソッドを使用して、Zoho Recruitで候補者を求人に関連付けることができます。
メモ:これらのパラメーターを渡すには、GETメソッドではなくPOSTメソッドを使用してください。

リクエストURL

XMLフォーマット:
https://recruit.zoho.com/recruit/private/xml/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi

JSONフォーマット:
https://recruit.zoho.com/recruit/private/json/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi

OAuth認証の場合

ヘッダー名

Authorization
Zoho-oauthtoken {access_token}

スコープ

Scope=ZohoRecruit.modules.all
(または)
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
使用可能なスコープ名(大文字と小文字を区別)
操作の種類
associatejobopening
ALL - データに対するすべての権限
READ - タブからデータを取得

Authtoken認証の場合

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

リクエストパラメーター

パラメーター データ型 詳細
jobIds* 文字列 求人データの一意のIDを指定します。
candidateIds* 文字列 上記のjobIdsに関連付ける候補者IDをカンマ区切りで指定します。
version* 整数 使用する値は version=2:最新のAPI実装に基づいてレスポンスを取得します。
status 文字列 関連付けられている求人に対する候補者のステータスを指定します。
標準では、関連付け時のステータスは「関連付け済み」になります。
comments 文字列 関連付けのコメントを指定します。

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


外部のアプリケーションを使用してZoho Recruitで求人を関連付けるには。
URLフォーマット。
https://recruit.zoho.com/recruit/private/xml/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi&jobIds=292114000000087156
&candidateIds=292114000000139404,292114000000139403
レスポンスフォーマット。
<response uri='/recruit/private/xml/Candidates/associateJobOpening'>
<result>
<message>候補者を正常に関連付けました</message>
<recorddetail>
<FL val='jobIds'>
292114000000087156,292114000000087140,292114000000087124
</FL>
<FL val='candidateIds'>292114000000139404,292114000000139403</FL>
</recorddetail>
</result>
</response>