技術資料

SendGrid APIを使ったRecipientの操作方法

2023.04.19

error この記事は最終更新日から1年以上が経過しています。

SendGridではメールアドレスを Recipient という名前で扱う。

Recipientの追加

参考: APIリファレンス

$data = array(
	'email'           => 'test@test.com',
	'last_name'       => '阿部',
	'office_name'     => 'グッドホープ',
);
$json_data = json_encode($data);
		
$api_url = "https://api.sendgrid.com/v3/contactdb/recipients";
$headers = array(
	'Content-Type: application/json',
	'Authorization: Bearer '.SENDGRID_API_KEY
);

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '['.$json_data.']');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if($status_code < 200 || $status_code >= 300){
	print "API error ==addSingleRecipient {$status_code}==";
	return FALSE;
}
$result = json_decode($response);
if(isset($result->errors[0])){
	print "API error ==addSingleRecipient {$result->errors[0]->message}==";
	return FALSE;
}
if(!isset($result->persisted_recipients[0]) || $result->persisted_recipients[0] == ''){
	print "API error ==addSingleRecipient Unpersisted==";
	return FALSE;
}
return $result->persisted_recipients[0];

persisted_recipients の配列に、登録されたアドレスのIDが入る。

Recipientの削除

参考: APIリファレンス

$mail = 'test@test.com';
$recipient_id = base64_encode($mail);

$api_url = "https://api.sendgrid.com/v3/contactdb/recipients/{$recipient_id}";
$headers = array(
    'Content-Type: application/json',
    'Authorization: Bearer '.SENDGRID_API_KEY
);

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if($status_code < 200 || $status_code >= 300){
    print "API error ==deleteRecipient {$status_code}==";
    return FALSE;
}
return TRUE;

recipiend_id は、メールアドレスをBASE64エンコードした文字列。

SendGrid APIでPHPからUnsubscribe Groupsを取得する

2023.04.21

SendGridのUnsubscribe Groupsは、受信者が配信停止できるメールタイプを管理する機能です。この記事では、APIを使って全グループの情報を取得する方法を解説します。

PHP SendGrid API

SendGrid APIで送信者情報を取得する方法

2023.04.20

SendGridのAPIを使って、全送信者情報を簡単に取得する方法を紹介します。

PHP SendGrid API

SendGridのCampaigns API活用ガイド:作成から送信スケジュールまで

2023.04.19

SendGridのCampaigns APIを使ったマーケティングキャンペーン管理の方法を詳しく解説します。PHPを利用してキャンペーンの作成、ステータス確認、内容更新、スケジュール設定・更新・キャンセルを行うコード例を紹介。

PHP SendGrid API

SendGrid APIでPHPからリストを操作する方法

2023.04.19

PHPからSendGridのリスト管理を行なう方法を解説します。リストの作成、特定リストの検索、メールアドレスの登録といった基本的な操作を、具体的なコード例を交えて説明します。

PHP SendGrid API

阿部辰也へのお仕事の依頼・お問い合わせ

お名前 *必須
会社名
メールアドレス *必須
電話番号
URL
お問い合わせのきっかけ
お問い合わせの内容 *必須
個人情報の取り扱いについて *必須 プライバシーポリシーをご確認いただき、同意いただける場合は「同意する」にチェックをしてください。

keyboard_double_arrow_up
TOP