「IDを使ってレコードを取得する」

「IDを使ってレコードを取得する」

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

目的

レコードIDによって個々のレコードを取得するために、この方法を使用することができます。

リクエストURL

XML 形式： 
https://recruit.zoho.com/recruit/private/xml/Module/getRecordById?authtoken=AuthToken&scope=recruitapi&version=2&id=RecordID

JSON 形式：
https://recruit.zoho.com/recruit/private/json/Module/getRecordById?&authtoken=AuthToken&scope=recruitapi&version=2&id=RecordID
注：モジュールとは、候補者、求人、クライアント、インタビュー、コンタクト、カスタムモジュール1、カスタムモジュール2、カスタムモジュール3、カスタムモジュール4、カスタムモジュール5を指します。

OAuth 認証のために

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

スコープ

スコープ=ZohoRecruit.モジュール.すべて
(または)
スコープ=ZohoRecruit.モジュール.{スコープ名}.{操作タイプ}
可能なスコープ名（大文字と小文字を区別）
操作タイプ
候補者、求人、顧客、部署、面接、連絡先、カスタム（すべてのカスタムモジュール用）)
 ALL - レコードへの完全なアクセス
READ - モジュールからレコードを取得

認証トークン認証について

パラメーター
 データ型
 説明
authtoken*
 String
 暗号化された英数字文字列を使用して、Zohoの資格情報を認証します。 
スコープ*
 文字列
 値を指定します recruitapi

リクエストパラメーター

パラメーター
 データ型
 説明
id*
 String

id：レコードの固有IDを指定してください。

新しいフォーマット
 整数（1または2）
 新しいフォーマット=1： レクルートからデータを取得する際に、'null'値を除外します。 新しいフォーマット=2： レクルートからデータを取得する際に、'null'値を含めます。
バージョン
 整数
 version = 2: これにより、最新のAPI実装に基づいたレスポンスが取得されます。

注意: * でマークされたパラメータは必須です。

求人特定パラメータ

パラメーター
 データ型
 説明
publishURL
 ブーリアン

値を true に設定すると、求人詳細URLと求人応募URLが取得できます。デフォルトでは、この値は falseです。

注意: ジョブURLは、「ウェブサイトで公開」でジョブを公開した場合にのみ表示されます。

例

IDによるレコードの取得を行うには、
URL 形式:
https://recruit.zoho.com/recruit/private/xml/Candidates/getRecordById?authtoken=認証トークン&scope=recruitapi&version=2&id=ID

新しいフォーマットパラメーターを指定せずに候補者を取得する
注意:レスポンス形式が指定されない場合、新しいFormatパラメーターにデフォルト値「1」が割り当てられます、つまり、newFormat=1となります。
URL形式：
https://recruit.zoho.com/recruit/private/xml/Candidates/getRecordByIdauthtoken=AuthToken&scope=recruitapi&id=2000000022020&version=2&selectColumns=Candidates(FirstName,LastName,Email,Current Employer,Source,Phone)
テクニカルヘルプガイドの翻訳について、私からあなたに依頼します。HTMLコンテンツに英語のテキストが含まれていますので、英語のテキストを丁寧でビジネス適切な自然な表現で日本語に翻訳してください。HTMLタグや属性を変更したり、追加のコンテンツを生成したりしないでください。英語のテキストが他の言語に翻訳されないようにしてください。
<候補者>
<row no='1'>「１番目の行」
<FL val='CANDIDATEID'>2000000022020</FL>
<FL val='SMOWNERID'>2000000018005</FL>
<FL val='候補者の所有者'>John</FL>
<FL val='Company'>ジリアム</FL>
<FL val='名'>スコット</FL>
<FL val='苗字'>ジェームス</FL>
<FL val='従業員数'>10</FL>
<FL val='年間収入'>1000.0</FL>
<FL val='SMCREATORID'>2000000016908</FL>
<FL val='作成者'>John</FL>
<FL val='作成日時'>2010-03-16 10:04:52</FL>
<FL val='修正時間'>2010-03-16 10:04:52</FL>
</row>
</候補者>