写真のアップロード

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

目的

このメソッドを使用して、候補者または連絡先の写真をアップロードできます。

リクエストURL

XMLフォーマット。

候補者の場合：
https://recruit.zoho.com/recruit/private/xml/Candidates/uploadPhoto?authtoken=AuthToken&scope=recruitapi&id=RecordId&content=File Input Stream&version=2

連絡先の場合：
https://recruit.zoho.com/recruit/private/xml/Contacts/uploadPhoto?authtoken=AuthToken&scope=recruitapi&id=RecordId&content=File Input Stream&version=2

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*	文字列	Zohoの認証情報を認証するための、暗号化済みの英数字の文字列です。
scope*	文字列	値には recruitapi を指定します

リクエストパラメーター

パラメーター	データ型	詳細
id*	文字列	データの一意のIDを指定します。
content*	FileInputStream	写真のFileInputStreamを渡します。
version*	整数	使用：version=2：最新のAPI実装に基づいてレスポンスを取得します。

メモ：

*が付いたパラメーターは必須です。
各写真のサイズは2MBを超えないようにしてください。サイズが2MBを超えると、次のエラーメッセージが表示されます：「ファイルサイズは2MBを超えないようにしてください。」

候補者または連絡先の写真のアップロード用Javaコード

候補者または連絡先の写真をアップロードするには、このプログラムをお使いのJava環境で実行できます。

プログラムでは、次の値を指定する必要があります。

認証トークン
データのID
上記のフォーマットのuploadPhotoリクエストURL
ファイルのパス（写真の場所）

コード例。

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 targetURL = ' https://recruit.zoho.com/recruit/private/xml/Candidates/uploadPhoto ';

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), };

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();

}

レスポンス例。

<?xml version='1.0' encoding='UTF-8' ?>
<response uri='/recruit/private/xml/Candidates/uploadPhoto'>
<status>
<code>200</code>
</status>
<success>
<code>4800</code>
<message>Photo uploaded successfully</message>
</success>
</response>

候補者または連絡先の写真をアップロードするためのPHPコード（PHPバージョン5.5以降）

コード例。

<?php
$recordId='RECORD ID';
$ch=curl_init();
$cFile = new CURLFile('/home/path/to/my/photo.png','image/png',')
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/uploadPhoto?authtoken= <Your Authtoken>&scope=recruitapi&version=2');
curl_setopt($ch,CURLOPT_POST,true);
$post=array('id'=>$recordId,'content'=>$cFile);
curl_setopt($ch,CURLOPT_POSTFIELDS,$post);
$response=curl_exec($ch);
echo $response;
?>