ファイルのアップロード

ファイルのアップロード

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

目的

このメソッドを使用して、データにファイルを添付できます。

リクエストURL

XML形式。

JSON形式。

OAuth認証の場合

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

スコープ

Scope=ZohoRecruit.modules.all
（または）
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
指定可能なスコープ名（大文字と小文字を区別）
 操作の種類
referral, campaign, assessment, vendor, offer, attachment,
forecast, note, call, event, task, candidate, jobopening, client, department, interview, contact & custom（すべてのカスタムタブ用）
ALL - データへのすべての権限
READ - タブからデータを取得

Authtoken認証の場合

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

リクエストパラメーター

パラメーター
 データ型
 詳細
id*
 文字列
 ファイルを添付するデータの一意のIDを指定します。
content*
 FileInputStream
 ファイルのファイル入力ストリームを渡します。
type*
 文字列
 添付ファイルの種類を指定します（例：履歴書、その他）。
version*
 整数
 使用する値はversion=2です。これにより、最新のAPI実装に基づいてレスポンスを取得します。
メモ。
  1. *が付いているパラメーターは必須です。
  2. ファイルの合計サイズは20MBを超えないようにしてください。
  3. このプログラムで要求できるuploadFileの呼び出しは、5分あたり15回までです。APIユーザーが15回を超える呼び出しを要求した場合、システムはAPIアクセスを15分間ブロックします。
  4. サイズが20MBを超えると、次のエラーメッセージが表示されます：「ファイルサイズは20MBを超えないようにしてください」。
  5. 添付したファイルは、データの詳細ページの添付ファイルセクションで確認できます。
  6. レポート、ダッシュボード、売上予測を除くすべてのタブのデータにファイルを添付できます。

データにファイルをアップロードするJavaコード

データにファイルをアップロードするには、Java環境でこのプログラムを実行できます。
プログラム内で、次の値を指定する必要があります。
  1. 自分の認証トークン
  2. データのID
  3. 上記のフォーマットのuploadFileリクエストURL
  4. ファイルのパス（ファイルの場所）
コード例。
import java.io.*;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.*;
import org.apache.commons.httpclient.methods.multipart.Part;
import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.multipart.StringPart;
import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity;
import org.apache.commons.httpclient.methods.multipart.PartSource;
import org.apache.commons.httpclient.methods.multipart.ByteArrayPartSource;
 
public class UploadFile
{
public static void main(String a[])
{
try
{
String auth_token = 'USER AUTH TOKEN';
String auth_scope = 'recruitapi';
String recordId = 'RECORD ID';
String file = 'FILE NAME
File f = new File(file);
FileInputStream fis = new FileInputStream(f);
ByteArrayOutputStream bos = new ByteArrayOutputStream();
int c;
while ((c = fis.read()) != -1)
{
bos.write(c);
}
byte[] fbArray = bos.toByteArray();
targetURL = targetURL + '?authtoken='+ auth_token +'&scope='+ auth_scope+'&version=2';
PartSource ps = new ByteArrayPartSource(file,fbArray);
PostMethod post =new PostMethod(targetURL);
Part[] fields = { new FilePart('content',ps), new StringPart('id', recordId), new StringPart('type', 'Cover Letter') };
post.setRequestEntity(new MultipartRequestEntity(fields,post.getParams()));
HttpClient httpclient = new HttpClient();
httpclient.executeMethod(post);
String postResp = post.getResponseBodyAsString();
System.out.println('postResp===========> : '+postResp);
}
catch(Exception e)
{
e.printStackTrace();
}
}
}

データにファイルをアップロードするPHPコード（PHP 5.5以降）

コード例。
<?php
$recordId='RECORD ID';
$ch=curl_init();
$cFile = new CURLFile('/home/path/to/my/file.pdf','application/pdf',')
curl_setopt($ch,CURLOPT_HEADER,0);
curl_setopt($ch,CURLOPT_VERBOSE,0);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_URL,'https://recruit.zoho.com/recruit/private/xml/Candidates/uploadFile?authtoken=<Your Authtoken>&scope=recruitapi&version=2&type=<attachment type>');
curl_setopt($ch,CURLOPT_POST,true);
$post=array('id'=>$recordId,'content'=>$cFile);
curl_setopt($ch,CURLOPT_POSTFIELDS,$post);
$response=curl_exec($ch);
echo $response;
?>

レスポンス例

<?xml version='1.0' encoding='UTF-8' ?>
<response uri='/recruit/private/xml/Candidates/uploadFile'>
<result>
<message>File has been attached successfully</message>
<recorddetail>
<FL val='Id'>335751000000578001</FL>
<FL val='Created Time'>2012-06-20 14:57:34</FL>
<FL val='Modified Time'>2012-06-20 14:57:34</FL>
<FL val='Created By'><![CDATA[krrish]]></FL>
<FL val='Modified By'><![CDATA[krrish]]></FL>
</recorddetail>
</result>
</response>

データ容量の上限

組織の標準のストレージ上限は次のとおりです。
  1. 無料プラン-組織あたり256MB
  2. スタンダードプラン-1GB
  3. プロフェッショナルプラン-2GB
  4. エンタープライズプラン-3GB
追加のファイルストレージ：1GBあたり月額3米ドル
既存のユーザーには、改定後の価格が次回の請求サイクルから適用されます。