「関連レコードの取得」

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

目的

getRelatedRecords メソッドを使用して関連レコードを取得できます。

例えば、キャンペーンに関連する候補者を取得したり、クライアントに関連するタスクを取得することができます。

リクエストURL

XML 形式:

https://recruit.zoho.com/recruit/private/xml/Notes/getRelatedRecords?authtoken=Auth Token&scope=recruitapi&id=レコードID&parentModule=モジュール名&version=2

JSON 形式:

https://recruit.zoho.com/recruit/private/json/Notes/getRelatedRecords?authtoken=Auth Token&scope=recruitapi&id=レコードID&parentModule=モジュール名&version=2

OAuth 認証のために

ヘッダー名	値
承認	Zoho-oauthtoken {アクセストークン}

スコープ

範囲=ZohoRecruit.modules.all

(または)

範囲=ZohoRecruit.modules.{scope_name}.{operation_type}

可能なスコープ名（大文字小文字を区別）	操作タイプ
紹介、キャンペーン、評価、ベンダー、添付、予測、ノート、コール、イベント、タスク、候補者、職務開発、クライアント、部門、インタビュー、連絡先、カスタム（すべてのカスタムモジュール用））	ALL - レコードへの完全なアクセス READ - モジュールからレコードを取得する

認証トークン認証のために

パラメータ	データ型	説明
authtoken*	String	暗号化されたアルファベット数字文字列を使用して、Zohoの認証を行います。
スコープ*	文字列	値を指定してください recruitapi

リクエストパラメーター

パラメーター	データ型	説明
親モジュール*	文字列	関連レコードを取得したいモジュール例：キャンペーンに関連する候補者を取得したい場合、キャンペーンが親モジュールです。
id*	整数	関連レコードを取得したいレコードのID
新しいフォーマット	整数	新しいフォーマット=1: Recruitアカウントからデータを挿入する際、'null'値を含むフィールドを除外します。新しいフォーマット=2: Recruitアカウントからデータを挿入する際、'null'値を含むフィールドも含めます。
fromIndex	整数	デフォルト値 - 1
toIndex	Integer	デフォルト値 - 20 最大値 - 200
バージョン*	整数	使用バージョン=2: これにより、最新のAPI実装に基づいた応答が取得されます。

注意:

*でマークされたパラメーターは必須です。
getRelatedRecordsメソッドはカスタムルックアップフィールドをサポートしていません。

例

レコードに添付されたファイルを表示するには

URLフォーマット：

https://recruit.zoho.com/recruit/private/xml/Attachments/getRelatedRecords?authtoken=あなたのAuth Token&newFormat=1&scope=recruitapi&parentModule=Candidates&id=508020000000957321

サンプル応答:

<![CDATA[ 履歴書 ]]>

</FL>

</row>
<row no='2'>
<FL val='id'>5080200000000906253</FL>
<FL val='ファイル名'>
<![CDATA[ image.jpeg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.55 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>

<![CDATA[ その他 ]]>

</FL>

</row>
<row no='3'>
<FL val='id'>5080200000009873561</FL>
<FL val='ファイル名'>
<![CDATA[ サンプル画像.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 11.47 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ チャールズ・ストーン]]>

<![CDATA[ その他 ]]>

</FL>

</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>