SendGrid への接続を追加

1. アプリケーションコンソールで、接続ページに移動します。
2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
3. SendGrid アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからSendGrid コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

SendGrid Sync App 経由で認証するには、API キーを使用する必要があります。

API キーの取得

API キーを取得するには以下の手順に従ってください。

1. SendGrid にログインします。
2. ［Settings］をクリックします。
3. ［API keys］をクリックします。
4. ［Create API Key］をクリックします。
5. API キーの権限を選択します。Full Access またはRestricted Access のいずれかです。その後、API キーが表示されます。

NOTE： E メールイベントにアクセスする場合は、SendGrid のEmail Activity History アドインを購入する必要があります。Restricted Access のキーを使用する場合は、messages.read およびemail_activity.read スコープを与える必要があります。

このセクションでは、SendGrid Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App を使用すると、事前設定されたクエリによって内容が決定されるユーザー定義ビューと呼ばれる仮想テーブルを定義できます。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。

SSL の設定

SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。 詳しくは、接続文字列オプションにあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、SendGrid にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくはクエリ処理 を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングでは、 次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、 より洗練されたロギングをサポートする多数の機能があります。

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。

別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。

さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。

その他のプロキシ

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

Sync App は、SendGrid API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。大抵のテーブル、ビュー、およびストアドプロシージャは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

しかし、Recipients テーブルは動的です。Sync App は、SendGrid に接続し、適切なWeb サービスを呼び出してこのテーブルのメタデータを取得します。Recipients テーブルに定義したカスタムフィルタに加えた変更はすべて接続時に利用可能です。これらのカスタムフィルタはWHERE 句内でカラムとして使用できます。これらのカスタムフィルタはCustomFields テーブル内に表示されます。

このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

新しいMarketing Campaigns データモデル

新しいMarketing Campaigns API で利用可能なエンティティについては、新しいMarketing Campaigns データモデル を参照してください。

レガシーデータモデル

Legacy API で利用可能なエンティティについては、レガシーデータモデル を参照してください。

CData Sync App は、新しいMarketing Campaigns API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。ほとんどのテーブル、ビュー、ストアドプロシージャは、スキーマファイルに定義されています。テキストベースのシンプルな設定ファイルです。 このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

新しいMarketing Campaigns データモデルを使用するには、Schema をNMC に設定します。

テーブル

テーブル は、簡単にクエリや更新ができる利用可能なテーブルについて説明します。

ビュー

ビュー は変更ができないテーブルです。一般的に、読み取り専用のデータはビューとして表示されます。

ストアドプロシージャ

ストアドプロシージャ は、Sendgrid のファンクションライクなインターフェースです。これらを使用して、情報を検索、更新、および変更できます。

Sync App はSendGrid のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

SendGrid Connector for CData Sync テーブル

Create, update, delete, and query Alerts in SendGrid.

テーブル固有の情報

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM Alerts
SELECT * FROM Alerts WHERE Id = '148825'

Insert

Stats Notification の挿入には、次のカラムが必須です：Type、EmailTo、Frequency。

INSERT INTO Alerts (Type, EmailTo, Frequency) VALUES ('stats_notification', '[email protected]', 'daily')

Usage Limit の挿入には、次のカラムが必須です：Type、EmailTo、Percentage。

INSERT INTO Alerts (Type, EmailTo, Percentage) VALUES ('usage_limit', '[email protected]', 20)

Update

Id を指定することでEmailTo を更新できます。

UPDATE Alerts SET EmailTo = '[email protected]' WHERE Id = 1310789

Delete

Id を指定することでAlerts から削除できます。

DELETE FROM Alerts WHERE Id = 1310789

Columns

Query, Create, Update and Delete the available ApiKeys in SendGrid.

テーブル固有の情報

Select

すべてのApi Keys を取得します

SELECT * FROM ApiKeys

特定のApi Key に関する情報を取得します

SELECT * FROM Apikeys WHERE ApiKeyId = 'Dqdvdvdvdv4yLeuVQqO3rFxN5ktUxA'

Insert

挿入には、次のカラムが必須です：Name。 Scopes の値は次のとおりです: alerts.create, alerts.read, alerts.update, alerts.delete, asm.groups.create, asm.groups.read, asm.groups.update, asm.groups.delete, ips.pools.ips.read, mail.send, mail_settings.bcc.read, mail_settings.bcc.update, mail_settings.address_whitelist.read, mail_settings.address_whitelist.update, mail_settings.footer.read, mail_settings.footer.update, mail_settings.forward_spam.read, mail_settings.forward_spam.update, mail_settings.plain_content.read, mail_settings.plain_content.update, mail_settings.spam_check.read, mail_settings.spam_check.update, mail_settings.bounce_purge.read, mail_settings.bounce_purge.update, mail_settings.forward_bounce.read, mail_settings.forward_bounce.update, partner_settings.new_relic.read, partner_settings.new_relic.update, partner_settings.sendwithus.read, partner_settings.sendwithus.update, tracking_settings.click.read, tracking_settings.click.update, tracking_settings.subscription.read, tracking_settings.subscription.update, tracking_settings.open.read, tracking_settings.open.update, tracking_settings.google_analytics.read, tracking_settings.google_analytics.update, user.webhooks.event.settings.read, user.webhooks.event.settings.update, user.webhooks.event.test.create, user.webhooks.event.test.read, user.webhooks.event.test.update, user.webhooks.parse.settings.create, user.webhooks.parse.settings.read, user.webhooks.parse.settings.update, user.webhooks.parse.settings.delete, stats.read, stats.global.read, categories.stats.read, categories.stats.sums.read, devices.stats.read, clients.stats.read, clients.phone.stats.read, clients.tablet.stats.read, clients.webmail.stats.read, clients.desktop.stats.read, geo.stats.read, mailbox_providers.stats.read, browsers.stats.read, user.webhooks.parse.stats.read, templates.create, templates.read, templates.update, templates.delete, templates.versions.create, templates.versions.read, templates.versions.update, templates.versions.delete, templates.versions.activate.create, user.timezone.read, user.timezone.update, user.settings.enforced_tls.read, user.settings.enforced_tls.update, api_keys.create, api_keys.read, api_keys.update, api_keys.delete, email_activity.read, categories.create, categories.read, categories.update, categories.delete, mail_settings.template.read, mail_settings.template.update, marketing_campaigns.create, marketing_campaigns.read, marketing_campaigns.update, marketing_campaigns.delete, mail.batch.create, mail.batch.read, mail.batch.update, mail.batch.delete, user.scheduled_sends.create, user.scheduled_sends.read, user.scheduled_sends.update, user.scheduled_sends.delete, access_settings.whitelist.create, access_settings.whitelist.read, access_settings.whitelist.update, access_settings.whitelist.delete, access_settings.activity.read, whitelabel.create, whitelabel.read, whitelabel.update, whitelabel.delete, suppression.create, suppression.read, suppression.update, suppression.delete, messages.read

INSERT INTO Apikeys (Name) VALUES ('apiname')

INSERT INTO Apikeys (Name, Scopes, Sample) VALUES ('apiname', 'alerts.create,alerts.read', 'test')

Update

ApiKeyid を指定することでApiKeys を更新できます。更新を希望しない場合でも、UPDATE 中に名前とスコープの両方を指定する必要があります。

UPDATE Apikeys SET Name = 'apiname2', Scopes = 'alerts.create,alerts.read' WHERE apikeyid = 'Dqdvdvdvdv4yLeuVQqO3rFxN5kscsctUxA-P_Q'

Delete

ApiKeyid を指定してApiKeys を削除することができます。

DELETE FROM ApiKeys WHERE apikeyid = 'CMp4C8klscscscsQ0GxqvxtK2-P_Q'

Columns

Query and Delete the available Blocks in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去120日間のデフォルト期間が適用されます。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM Blocks WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

Delete

Email を指定することでBlocks から削除できます。

DELETE FROM Blocks WHERE Email = '[email protected]'

Columns

Query and Delete the available Bounces in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去120日間のデフォルト期間が適用されます。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM Bounces WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

Delete

Email を指定することでBounces から削除できます。

DELETE FROM Bounces WHERE Email = '[email protected]'

Columns

Update, delete, and query Cancel Scheduled Sends in SendGrid.

テーブル固有の情報

Select

このテーブルはBatchId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM CancelScheduledSends
SELECT * FROM CancelScheduledSends WHERE BatchId = 148825

Update

BatchId を指定してCancelScheduledSends を更新することができます。

使用できる値はcancel、pause です。

UPDATE CancelScheduledSends SET Status = 'cancel'  WHERE BatchId = 1310789

Delete

BatchId を指定することでCancelScheduledSends から削除できます。

DELETE FROM CancelScheduledSends WHERE BatchId = 1310789

Columns

Query Global Unsubscribes in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。ただし、このフィルタは任意です。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM GlobalUnsubscribes WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

INSERT

このテーブルでInsert 操作を行うには、GlobalUnsubscribes リストに追加されるE メールを指定する必要があります。次に例を示します。

INSERT INTO GlobalUnsubscribes (Email) VALUES ('[email protected]')

DELETE

このテーブルでDelete 操作を行うには、GlobalUnsubscribes リストから削除されるE メールを指定する必要があります。次に例を示します。

DELETE FROM GlobalUnsubscribes WHERE Email = '[email protected]'

Columns

Query and Delete invalid emails in SendGrid.

テーブル固有の情報

Select

このテーブルはEmail によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM InvalidEmails
SELECT * FROM InvalidEmails WHERE Email = '[email protected]'

Delete

Email を指定することでInvalidEmails から削除できます。

DELETE FROM InvalidEmails WHERE Email = '[email protected]'

Columns

Create, delete, and query New Marketing Campaign Custom Fields in SendGrid.

テーブル固有の情報

新しいMarketing Campaign のカスタムフィールドは、ユーザーにより指定された連絡先を分類するフィルタです。NMC プレフィックスは、New Marketing Campaign の略です。

Select

すべてのNMCCustomFields の取得、またはId でのフィルタが可能です。

SELECT * FROM NMCCustomFields WHERE Id = '1'

タイプに関係なく、NMC Custom Fields をフィルタするには引用符を使用します。

Insert

NMCCustomFields に挿入するには、フィールド名とその種類の指定が必要です。タイプは、text、date、およびnumber が使用できます。

INSERT INTO NMCCustomFields (name, type) VALUES ('age', 'number') 

Update

UPDATE NMCCustomFields SET name = 'updated name' WHERE Id = '123' 

Delete

Id を指定することでNMCCustomFields から削除できます。

DELETE FROM NMCCustomFields WHERE Id = '1'

Columns

Create, update, delete, and query the available New Marketing Campaign Lists in SendGrid.

テーブル固有の情報

NMC プレフィックスは、New Marketing Campaign の略です。

Select

NMCLists テーブルはId によってのみフィルタできます。

SELECT * FROM NMCLists WHERE Id = '123'

Insert

テーブルへの挿入には、NMCLists の名前のみ必要です。

INSERT INTO NMCLists (Name) VALUES ('TestList')

Update

Id を指定することでNMCLists を更新できます。

UPDATE NMCLists SET Name = 'New Name' WHERE Id = '123'

Delete

Id を指定することでNMCLists から削除できます。

DELETE FROM NMCLists WHERE Id = '123'

Columns

Create, update, delete, and query New Marketing Campaign Segments in SendGrid.

テーブル固有の情報

NMC プレフィックスは、New Marketing Campaign の略です。

Select

すべてのセグメントの取得、またはId でのフィルタが可能です。

SELECT * FROM NMCSegments WHERE Id = '1'

Insert

特定の抽出条件によってセグメントはNMCContacts を分割できます。これらの抽出条件を指定するには、QueryDSL フィルタを使用します。

INSERT INTO NMCSegments (Name, QueryDSL) VALUES ("New Segment", "Segment Cdata", "first_name LIKE '%test%'"))

上記のステートメントは、値 "test" を含むFirstName を持つNMCContacts を含んだNMCSegments を作成します。

Update

名前またはコンディションを更新することができます。すべてのセットが上書きされるので、フルセットを指定してください。

UPDATE NMCSegments SET Name = "Name Updated", QueryDSL = "first_name LIKE '%test update%'" WHERE Id = '123'

Delete

Id でのみNMCSegments を削除できます。

DELETE FROM NMCSegments WHERE Id = '123'

Columns

Create, update, delete, and query New Marketing Campaign Senders in SendGrid.

テーブル固有の情報

NMC は、New Marketing Campaign の略です。

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM NMCSenders
SELECT * FROM NMCSenders WHERE Id = '148825'

Insert

挿入には、次のカラムが必須です：Nickname、FromEmail、FromName、ReplytoEmail、Address、City、Country。

INSERT INTO NMCSenders (Nickname, FromEmail, FromName, ReplytoEmail, Address, City, Country) VALUES ('Nickname', 'FromEmail', 'FromName', 'ReplytoEmail', 'Address', 'City', 'Country')

Update

Id を指定してNMCSenders を更新することができます。

UPDATE NMCSenders SET Nickname = 'Nickname', FromEmail = 'FromEmail', FromName = 'FromName', ReplytoEmail = 'ReplytoEmail', Address = 'Address', City = 'City', Country = 'Country'  WHERE Id = 1310789

Delete

Id を指定することでAlerts から削除できます。

DELETE FROM NMCSenders WHERE Id = 1310789

Columns

Create, update, delete, and query the available New Marketing Campaign Single Sends in SendGrid.

テーブル固有の情報

NMC は、New Marketing Campaign の略です。

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM NMCSingleSends
SELECT * FROM NMCSingleSends WHERE Id = '148825'

Insert

挿入には、次のカラムが必須です：Name。

INSERT INTO NMCSingleSends (Name) VALUES ('SingleSend Name')

Update

Id を指定してNMCSingleSends を更新することができます。

UPDATE NMCSingleSends SET Name = 'SingleSend Updated' WHERE Id = 1310789

Delete

Id を指定することでNMCSingleSends から削除できます。

DELETE FROM NMCSingleSends WHERE Id = 1310789

Columns

Query and delete Spam reports in SendGrid.

テーブル固有の情報

Select

このテーブルはEmail によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM Spam
SELECT * FROM Spam WHERE Email = '[email protected]'

Delete

Delete from Spam 

Email を指定することでSpam から削除できます。

DELETE FROM Spam WHERE Email = '[email protected]'

Columns

Query Teammates in SendGrid.

ビュー固有の情報

Select

• Usernameは、'=,IN' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SQL

SELECT * FROM Teammates WHERE Username = 'test'

SELECT * FROM Teammates WHERE Username IN ('test', 'test2')

Insert

挿入には、次のカラムが必須です：Email およびScopes。Scopes カラムは、値のカンマ区切りのリストを許容します。利用できる値は以下です：user.account.read, user.credits.read, user.email.create, user.email.read, user.email.update, user.email.delete, user.profile.create, user.profile.read, user.profile.update, user.profile.delete

IsAdmin は任意で、デフォルトではAPI からはfalse として受け取られます。

INSERT INTO Teammates (Email, Scopes) VALUES ('[email protected]', 'user.profile.read,user.profile.update')

INSERT INTO Teammates (Email, Scopes, IsAdmin) VALUES ('[email protected]', 'user.profile.read,user.profile.update', 'true')

Update

更新には、次のカラムが必須です：Username およびScopes。Scopes カラムは、値のカンマ区切りのリストを許容します。利用できる値は以下です：user.account.read, user.credits.read, user.email.create, user.email.read, user.email.update, user.email.delete, user.profile.create, user.profile.read, user.profile.update, user.profile.delete

UPDATE Teammates SET Scopes = 'user.profile.read' WHERE Username = 'testuser'

Delete

Teammates テーブルからレコードを削除するには、username カラムのみが必要です。次に例を示します。

DELETE FROM Teammates WHERE Username = 'testuser'

Columns

Create, update, delete, and query Unsubscribe Groups in SendGrid.

テーブル固有の情報

Select

UnsubscribeGroups はId によってのみフィルタできます。

SELECT * FROM UnsubscribeGroups WHERE Id = '1'

Insert

UnsubscribeGroups に挿入するには、名前と説明を指定します。

INSERT INTO UnsubscribeGroups (Name, Description, IsDefault) VALUES ('Unsubscribe1', 'General Unsubscribe', true)

Update

Id を指定することでUnsubscribeGroups を更新できます。

UPDATE UnsubscribeGroups SET Name = 'New Name', Description = 'New Description' WHERE Id = '1'

Delete

Id を指定することでUnsubscribeGroups から削除できます。

DELETE FROM UnsubscribeGroups WHERE Id = '1'

Columns

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

SendGrid Connector for CData Sync ビュー

Query the available Categories in SendGrid.

ビュー固有の情報

Select

このテーブルをクエリして、SendGrid で使用可能なカテゴリを取得します。

SELECT * FROM Categories

Columns

Query the available Category Stats in SendGrid.

ビュー固有の情報

Select

以下は、CategoryStats ビューをクエリする例です。

 
SELECT * FROM CategoryStats WHERE Name = 'news'

日付でフィルタをかけることもできます。指定しない場合は、過去1年間のデフォルト期間が適用されます。このカラムでは=、>=、<=、<、および> 演算子がサポートされています。

SELECT * FROM CategoryStats WHERE Name = 'news' AND Date > '2016-01-01' AND Date < '2016-01-30'

Columns

Query the available Global Stats in SendGrid.

ビュー固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去1年間のデフォルト期間が適用されます。Date カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM GlobalStats 

SELECT * FROM GlobalStats WHERE Date > '2016-01-01' AND Date < '2016-03-30'

Columns

Query group suppressions in SendGrid.

テーブル固有の情報

Select

以下は、GroupSuppressions テーブルをクエリする例です。

SELECT * FROM GroupSuppressions WHERE GroupId = 391

SELECT * FROM GroupSuppressions WHERE GroupId IN (391, 392, 393)

Columns

Query Global Unsubscribes in SendGrid.

ビュー固有の情報

Select

次のクエリのみがサーバーサイドで処理されます。

SQL

SELECT * FROM IPAccessManagement

Columns

List of events related to email message in SendGrid.

NOTE： E メールイベントにアクセスする場合は、SendGrid のEmail Activity History アドインを購入する必要があります。Restricted Access のキーを使用する場合は、messages.read およびemail_activity.read スコープを与える必要があります。

ビュー固有の情報

Select

• MessageId は'=' 比較演算子をサポートします。

SQL

SELECT * FROM MessageEvents WHERE MessageId = '1234'

Columns

Query Email Activities in SendGrid.

NOTE： E メールアクティビティにアクセスする場合は、SendGrid のEmail Activity History アドインを購入する必要があります。Restricted Access のキーを使用する場合は、messages.read およびemail_activity.read スコープを与える必要があります。

ビュー固有の情報

Select

Note：API は1000 レコードのみを返します。検索を制限するために、利用可能なフィルタから選択してください。

• Idは、'=,IN' 演算子をサポートします。
• Statusは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Subjectは、'=,!=,LIKE,NOT LIKE'演算子をサポートします。
• FromEmailは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• ToEmailは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Clicksは、'>,<,<=,>=,=,!=' 演算子をサポートします。
• LastEventTimeは、'>=, <=, BETWEEN' 演算子をサポートします。
• ApiKeyIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• AsmGroupIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• MarketingCampaignIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• MarketingCampaignNameは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• OriginatingIpは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• OutboundIpは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Teammateは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• TemplateIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SQL

SELECT * FROM Messages WHERE Id = '1234'

SELECT * FROM Messages WHERE Id IN ('1234', '4567')

SELECT * FROM Messages WHERE Status = 'not_delivered'

SELECT * FROM Messages WHERE LastEventTime BETWEEN '2020-01-01' AND '2020-01-15'

Columns

Query New Marketing Campaign Contacts in SendGrid.

ビュー固有の情報

新しいMarketing Campaign の連絡先はユーザーが管理する受信者です。NMC プレフィックスは、New Marketing Campaign の略です。

Select

すべてのNMCContacts の取得、またはId、ListId、SegmentId でのフィルタが可能です。

SELECT * FROM NMCCustomFields WHERE Id = '1'
SELECT * FROM NMCCustomFields WHERE Id IN ('1', '2', '3')
SELECT * FROM NMCCustomFields WHERE ListId = '1'
SELECT * FROM NMCCustomFields WHERE ListId IN ('1', '2', '3')
SELECT * FROM NMCCustomFields WHERE SegmentId = '1'
SELECT * FROM NMCCustomFields WHERE SegmentId IN ('1', '2', '3')

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the available New Marketing Campaign Reserved Fields in SendGrid.

ビュー固有の情報

Select

このテーブルは、フィルタリングをサポートしていません。NMC プレフィックスは、New Marketing Campaign の略です。

SELECT * FROM NMCReservedFields

Columns

Query Browser Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByBrowser WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Browser Statistics by name.

SELECT * FROM StatsByBrowser WHERE Name = 'Firefox'

Columns

Query Client Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByClient WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Client Statistics by name.

SELECT * FROM StatsByClient WHERE Name = 'Other'

Columns

Query Device Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByDevice WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Device Statistics by name.

SELECT * FROM StatsByDevice WHERE Name = 'Phone'

Columns

Query Location Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByLocation WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Location Statistics by name.

SELECT * FROM StatsByLocation WHERE Name = 'US'

To query Location Statistics by type.

SELECT * FROM StatsByLocation WHERE Type = 'country'

Columns

Query Mailbox Provider Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByMailboxProvider WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Mailbox Provider Statistics by name.

SELECT * FROM StatsByMailboxProvider WHERE Name = 'Microsoft Outlook Live'

Columns

Query Subuser Statistics in SendGrid.

ビュー固有の情報

Select

SubuserName でフィルタリングすると、特定のサブユーザーの統計情報を取得できます。

SELECT * FROM SubuserStats WHERE SubuserName = 'Example'

日付でフィルタをかけることもできます。このカラムでは=、>=、<=、<、および> 演算子がサポートされています。指定しない場合は、過去1年間のデフォルト期間が適用されます。

SELECT * FROM SubuserStats WHERE SubuserName = 'News' AND Date > '2016-01-01' AND Date < '2016-01-30'

Columns

Query the available Users in SendGrid.

ビュー固有の情報

Select

ユーザーはId によってのみフィルタできます。

SELECT * FROM Users WHERE Id = '1'

Columns

CData Sync App は、レガシーAPI をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。大抵のテーブル、ビュー、およびストアドプロシージャは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

しかし、Recipients テーブルは動的です。Sync App は、SendGrid に接続し、適切なWeb サービスを呼び出してこのテーブルのメタデータを取得します。Recipients テーブルに定義したカスタムフィルタに加えた変更はすべて接続時に利用可能です。これらのカスタムフィルタはWHERE 句内でカラムとして使用できます。これらのカスタムフィルタはCustomFields テーブル内に表示されます。

このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

従来のデータモデルを使用するには、Schema をLegacy に設定します。

テーブル

テーブル は、簡単にクエリや更新ができる利用可能なテーブルについて説明します。

ビュー

ビュー は変更ができないテーブルです。一般的に、読み取り専用のデータはビューとして表示されます。

ストアドプロシージャ

ストアドプロシージャ は、Sendgrid のファンクションライクなインターフェースです。これらを使用して、情報を検索、更新、および変更できます。

Sync App はSendGrid のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

SendGrid Connector for CData Sync テーブル

Create, update, delete, and query Alerts in SendGrid.

テーブル固有の情報

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM Alerts WHERE Id = '148825'

Insert

Stats Notification の挿入には、次のカラムが必須です：Type、EmailTo、Frequency。

INSERT INTO Alerts (Type, EmailTo, Frequency) VALUES ('stats_notification', '[email protected]', 'daily')

Usage Limit の挿入には、次のカラムが必須です：Type、EmailTo、Percentage。

INSERT INTO Alerts (Type, EmailTo, Percentage) VALUES ('usage_limit', '[email protected]', 20)

Update

Id を指定することでEmailTo を更新できます。

UPDATE Alerts SET EmailTo = '[email protected]' WHERE Id = 1310789

Delete

Id を指定することでAlerts から削除できます。

DELETE FROM Alerts WHERE Id = 1310789

Columns

Query, Create, Update and Delete the available ApiKeys in SendGrid.

テーブル固有の情報

Select

すべてのApi Keys を取得します

SELECT * FROM ApiKeys

特定のApi Key に関する情報を取得します

SELECT * FROM Apikeys WHERE ApiKeyId = 'Dqdvdvdvdv4yLeuVQqO3rFxN5ktUxA'

Insert

挿入には、次のカラムが必須です：Name。 Scopes の値は次のとおりです: alerts.create, alerts.read, alerts.update, alerts.delete, asm.groups.create, asm.groups.read, asm.groups.update, asm.groups.delete, ips.pools.ips.read, mail.send, mail_settings.bcc.read, mail_settings.bcc.update, mail_settings.address_whitelist.read, mail_settings.address_whitelist.update, mail_settings.footer.read, mail_settings.footer.update, mail_settings.forward_spam.read, mail_settings.forward_spam.update, mail_settings.plain_content.read, mail_settings.plain_content.update, mail_settings.spam_check.read, mail_settings.spam_check.update, mail_settings.bounce_purge.read, mail_settings.bounce_purge.update, mail_settings.forward_bounce.read, mail_settings.forward_bounce.update, partner_settings.new_relic.read, partner_settings.new_relic.update, partner_settings.sendwithus.read, partner_settings.sendwithus.update, tracking_settings.click.read, tracking_settings.click.update, tracking_settings.subscription.read, tracking_settings.subscription.update, tracking_settings.open.read, tracking_settings.open.update, tracking_settings.google_analytics.read, tracking_settings.google_analytics.update, user.webhooks.event.settings.read, user.webhooks.event.settings.update, user.webhooks.event.test.create, user.webhooks.event.test.read, user.webhooks.event.test.update, user.webhooks.parse.settings.create, user.webhooks.parse.settings.read, user.webhooks.parse.settings.update, user.webhooks.parse.settings.delete, stats.read, stats.global.read, categories.stats.read, categories.stats.sums.read, devices.stats.read, clients.stats.read, clients.phone.stats.read, clients.tablet.stats.read, clients.webmail.stats.read, clients.desktop.stats.read, geo.stats.read, mailbox_providers.stats.read, browsers.stats.read, user.webhooks.parse.stats.read, templates.create, templates.read, templates.update, templates.delete, templates.versions.create, templates.versions.read, templates.versions.update, templates.versions.delete, templates.versions.activate.create, user.timezone.read, user.timezone.update, user.settings.enforced_tls.read, user.settings.enforced_tls.update, api_keys.create, api_keys.read, api_keys.update, api_keys.delete, email_activity.read, categories.create, categories.read, categories.update, categories.delete, mail_settings.template.read, mail_settings.template.update, marketing_campaigns.create, marketing_campaigns.read, marketing_campaigns.update, marketing_campaigns.delete, mail.batch.create, mail.batch.read, mail.batch.update, mail.batch.delete, user.scheduled_sends.create, user.scheduled_sends.read, user.scheduled_sends.update, user.scheduled_sends.delete, access_settings.whitelist.create, access_settings.whitelist.read, access_settings.whitelist.update, access_settings.whitelist.delete, access_settings.activity.read, whitelabel.create, whitelabel.read, whitelabel.update, whitelabel.delete, suppression.create, suppression.read, suppression.update, suppression.delete, messages.read

INSERT INTO Apikeys (Name) VALUES ('apiname')

INSERT INTO Apikeys (Name, Scopes, Sample) VALUES ('apiname', 'alerts.create,alerts.read', 'test')

Update

ApiKeyid を指定することでApiKeys を更新できます。更新を希望しない場合でも、UPDATE 中に名前とスコープの両方を指定する必要があります。

UPDATE Apikeys SET Name = 'apiname2', Scopes = 'alerts.create,alerts.read' WHERE apikeyid = 'Dqdvdvdvdv4yLeuVQqO3rFxN5kscsctUxA-P_Q'

Delete

ApiKeyid を指定してApiKeys を削除することができます。

DELETE FROM ApiKeys WHERE apikeyid = 'CMp4C8klscscscsQ0GxqvxtK2-P_Q'

Columns

Query and Delete the available Blocks in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去120日間のデフォルト期間が適用されます。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM Blocks WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

Delete

Email を指定することでBlocks から削除できます。

DELETE FROM Blocks WHERE Email = '[email protected]'

Columns

Query and Delete the available Bounces in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去120日間のデフォルト期間が適用されます。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM Bounces WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

Delete

Email を指定することでBounces から削除できます。

DELETE FROM Bounces WHERE Email = '[email protected]'

Columns

Update, delete, and query Cancel Scheduled Sends in SendGrid.

テーブル固有の情報

Select

このテーブルはBatchId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM CancelScheduledSends
SELECT * FROM CancelScheduledSends WHERE BatchId = 148825

Update

BatchId を指定してCancelScheduledSends を更新することができます。

使用できる値はcancel、pause です。

UPDATE CancelScheduledSends SET Status = 'cancel' WHERE BatchId = 1310789

Delete

BatchId を指定することでCancelScheduledSends から削除できます。

DELETE FROM CancelScheduledSends WHERE BatchId = 1310789

Columns

Create, delete, and query Custom Fields in SendGrid.

テーブル固有の情報

カスタムフィールドは、ユーザーにより指定された受信者を分類するフィルタです。

Select

すべてのCustomFields の取得、またはId でのフィルタが可能です。

SELECT * FROM CustomFields WHERE Id = '1'

タイプに関係なく、Custom Fields をフィルタするには引用符を使用します。

Insert

CustomFields に挿入するには、フィールド名とその種類の指定が必要です。タイプは、text、date、およびnumber が使用できます。

INSERT INTO CustomFields (name, type) VALUES ('age', 'number') 

Update

このテーブルは、アップデートをサポートしていません。

Delete

Id を指定することでCustomFields から削除できます。

DELETE FROM CustomFields WHERE Id = '1'

Columns

Query Global Unsubscribes in SendGrid.

テーブル固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。ただし、このフィルタは任意です。CreatedAt カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM GlobalUnsubscribes WHERE CreatedAt > '2016-01-01' AND CreatedAt < '2016-01-30'

INSERT

このテーブルでInsert 操作を行うには、GlobalUnsubscribes リストに追加されるE メールを指定する必要があります。次に例を示します。

INSERT INTO GlobalUnsubscribes (Email) VALUES ('[email protected]')

DELETE

このテーブルでDelete 操作を行うには、GlobalUnsubscribes リストから削除されるE メールを指定する必要があります。次に例を示します。

DELETE FROM GlobalUnsubscribes WHERE Email = '[email protected]'

Columns

Query and Delete invalid emails in SendGrid.

テーブル固有の情報

Select

このテーブルはEmail によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM InvalidEmails
SELECT * FROM InvalidEmails WHERE Email = '[email protected]'

Delete

Email を指定することでInvalidEmails から削除できます。

DELETE FROM InvalidEmails WHERE Email = '[email protected]'

Columns

Create, update, delete, and query the available Lists in SendGrid.

テーブル固有の情報

Select

リストテーブルはId によってのみフィルタできます。

SELECT * FROM Lists WHERE Id = '123'

Insert

テーブルへの挿入には、リストの名前のみ必要です。

INSERT INTO Lists (Name) VALUES ('TestList')

Update

Id を指定することでLists から更新できます。

UPDATE Lists SET Name = 'New Name' WHERE Id = '123'

Delete

Id を指定することでLists から削除できます。

DELETE FROM Lists WHERE Id = '123'

Columns

Create, update, delete, and query Marketing Campaigns in SendGrid.

テーブル固有の情報

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM MarketingCampaigns
SELECT * FROM MarketingCampaigns WHERE Id = '1'

Insert

挿入は、次のカラムが必須です：Title、Subject、SenderId、ListIds、SegmentIds、Categories、SuppressionGroupId、HtmlContent、およびPlainContent。

CustomUnsubscribeUrl はSuppressionGroupId の代わりに使えます。ただし、SendGrid はSuppressionGroupId の使用を強く推奨しています。

以下のチェックポイントを使って、SenderId およびSuppressionGroupId のインプットを見つけてください。

• ［Marketing］->［MarketingCampaigns］->［Senders］の順に進むと、SenderId を見つけることができます。差し出し人情報がまだない場合は、新たに作ります。アクションカラム上の歯車をクリックし、［編集］を選択します。ナビゲーションバー上の / senders / id の後ろにId が表示されます。
• SuppressionGroupId を見つけるためには、UnsubscribeGroups テーブルに挿入し、作成されたId がSuppressionGroupId です。

INSERT INTO MarketingCampaigns (Title, Subject, SenderId, ListIds, Categories, SuppressionGroupId, HtmlContent, PlainContent) VALUES ('Test Campaign', 'March Newsletter', '123', '1,2', 'fruits, health', '12', '<b>Eat Healthy</b>', 'Eat healthy')

Update

Id を指定することでMarketingCampaigns を更新できます。

UPDATE MarketingCampaigns SET PlainContent = 'Eat healthier' WHERE Id = '123'

Delete

Id を指定することでMarketingCampaigns から削除できます。

DELETE FROM MarketingCampaigns WHERE Id = '123'

Columns

The SendGrid table Recipients.

テーブル固有の情報

SendGrid はユーザーにより定義されたフィルタでRecipients を分類できます。それに応じて、フィルタを使った検索やそれらのフィルタを挿入するためにRecipients テーブルにステートメントを実行します。しかし、これらのフィルタはカスタムフィールドテーブルの属性として記録されます。

Select

以下のクエリはRecipients テーブルのデフォルトフィールドのみ取得します。作成したカスタムフィールドは取得できません。受信者のカスタムフィールドの値を取得するには、カスタムフィールドテーブルをクエリします。

特定のリスト内またはセグメント内のすべてのRecipients を取得することもできますが、両方でのフィルタはできません。代わりに複数のクエリを使用します：

SELECT * FROM Recipients WHERE SegmentId = '1'
SELECT * FROM Recipients WHERE ListId = '2'

カスタムフィールドによって抽出条件を作成できます。タイプに関係なく、クエリでは引用符を使います。この種のフィルタリングはクライアント側で行われます。この場合、Age はユーザーによって作成されたカスタムフィールドです。

SELECT * FROM Recipients WHERE Age = '30'

Insert

Recipients に挿入するには、Email が必要です。

カスタムフィールドをRecipients テーブルに挿入できます。カスタムフィールドの作成に関する詳しい情報は、CustomFields セクションを参照してください。

INSERT INTO Recipients (Email, FirstName, LastName, Age, Department ... Other Custom Fields as necessary) VALUES ('[email protected]', 'name', 'surname', '30', 'Education' ... Other Custom Field values)

Update

Id を指定することでこのテーブルから更新できます。また、E メールカラムは更新ができません。

UPDATE Recipients SET Age = '12' WHERE Id = '1'

Delete

Id を指定することでこのテーブルから削除できます。

DELETE FROM Recipients WHERE Id = '1'

Columns

Create, update, delete, and query Campaign Schedules in SendGrid.

テーブル固有の情報

Select

以下は、Schedules テーブルをクエリする例です。

SELECT * FROM Schedules WHERE MarketingCampaignId = '123'

Insert

MarketingCampaignId とSendAt を指定すると、特定の時間にキャンペーンを設定できます。SendAt を指定するだけですぐにキャンペーンを送信できます。SendGrid でキャンペーンを送信するには、HTML とプレーンテキストの両コンテンツに [unsubscribe] タグが必要です。

INSERT INTO Schedules (MarketingCampaignId) VALUES (3091692)

INSERT INTO Schedules (MarketingCampaignId, SendAt) VALUES (1, '11/11/2018')

Update

MarketingCampaignId を指定することでスケジュールを更新できます。

UPDATE Schedules SET SendAt = '01-01-2016' WHERE MarketingCampaignId = '123'

Delete

MarketingCampaignId を指定することでスケジュールを削除できます。

DELETE FROM Schedules WHERE MarketingCampaignId = '123'

Columns

Create, update, delete, and query Segments in SendGrid.

テーブル固有の情報

Select

すべてのセグメントの取得、またはId でのフィルタが可能です。

SELECT * FROM Segments WHERE Id = '1'

Insert

特定の抽出条件によってセグメントは受信者を分割できます。抽出条件を指定するには、ConditionsField カラムと抽出条件を適用するリストのId を使います。

ConditionsAndOr カラムは与えられたフィールドと前のフィールドを接続します。

INSERT INTO Segments (Name, ListId, ConditionsField1, ConditionsValue1, ConditionsOperator1, ConditionsAndOr1, ConditionsField2, ConditionsValue2, ConditionsOperator2, ConditionsAndOr2) VALUES ("New Segment", 123, 'age', '20', '>', '', 'age', '30', '<', 'and')

上記のステートメントは20歳～30歳の受信者が含まれているセグメントを作成します。

Update

名前またはコンディションを更新することができます。すべてのセットが上書きされるので、フルセットを指定してください。

UPDATE Segments SET Name = 'Name Updated', ConditionsField1 = 'age', ConditionsOperator1 = '<=', ConditionsAndOr1 = '', ConditionsValue1 = '30' WHERE Id = '123'

Delete

Id を指定することでセグメントを削除できます。

DELETE FROM Segments WHERE Id = '123'

Columns

Create, update, delete, and query Sender Identities in SendGrid.

テーブル固有の情報

Select

このテーブルはId によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM SenderIdentities
SELECT * FROM SenderIdentities WHERE Id = '148825'

Insert

挿入には、次のカラムが必須です：Nickname、FromEmail、FromName、ReplytoEmail、Address、City、Country。

INSERT INTO SenderIdentities (Nickname, FromEmail, FromName, ReplytoEmail, Address, City, Country) VALUES ('Nickname', 'FromEmail', 'FromName', 'ReplytoEmail', 'Address', 'City', 'Country')

Update

Id を指定してSenderIdentities を更新することができます。

UPDATE SenderIdentities SET Nickname = 'Nickname', FromEmail = 'FromEmail', FromName = 'FromName', ReplytoEmail = 'ReplytoEmail', Address = 'Address', City = 'City', Country = 'Country' WHERE Id = 1310789

Delete

Id を指定することでAlerts から削除できます。

DELETE FROM SenderIdentities WHERE Id = 1310789

Columns

Query and delete Spam reports in SendGrid.

テーブル固有の情報

Select

このテーブルはEmail によるフィルタのみをサポートしています。唯一可能なSELECT クエリは次のとおりです。

SELECT * FROM Spam
SELECT * FROM Spam WHERE Email = '[email protected]'

Delete

Delete from Spam 

Email を指定することでSpam から削除できます。

DELETE FROM Spam WHERE Email = '[email protected]'

Columns

Query Teammates in SendGrid.

ビュー固有の情報

Select

• Usernameは、'=,IN' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SQL

SELECT * FROM Teammates WHERE Username = 'test'

SELECT * FROM Teammates WHERE Username IN ('test', 'test2')

Insert

挿入には、次のカラムが必須です：Email およびScopes。Scopes カラムは、値のカンマ区切りのリストを許容します。利用できる値は以下です：user.account.read, user.credits.read, user.email.create, user.email.read, user.email.update, user.email.delete, user.profile.create, user.profile.read, user.profile.update, user.profile.delete

IsAdmin は任意で、デフォルトではAPI からはfalse として受け取られます。

INSERT INTO Teammates (Email, Scopes) VALUES ('[email protected]', 'user.profile.read, user.profile.update')

INSERT INTO Teammates (Email, Scopes, IsAdmin) VALUES ('[email protected]', 'user.profile.read, user.profile.update', 'true')

Update

更新には、次のカラムが必須です：Username およびScopes。Scopes カラムは、値のカンマ区切りのリストを許容します。利用できる値は以下です：user.account.read, user.credits.read, user.email.create, user.email.read, user.email.update, user.email.delete, user.profile.create, user.profile.read, user.profile.update, user.profile.delete

UPDATE Teammates SET Scopes = 'user.profile.read' WHERE Username = 'testuser'

Delete

Teammates テーブルからレコードを削除するには、username カラムのみが必要です。次に例を示します。

DELETE FROM Teammates WHERE Username = 'testuser'

Columns

Create, update, delete, and query Unsubscribe Groups in SendGrid.

テーブル固有の情報

Select

UnsubscribeGroups はId によってのみフィルタできます。

SELECT * FROM UnsubscribeGroups WHERE Id = '1'

Insert

UnsubscribeGroups に挿入するには、名前と説明を指定します。

INSERT INTO UnsubscribeGroups (Name, Description, IsDefault) VALUES ('Unsubscribe1', 'General Unsubscribe', true)

Update

Id を指定することでUnsubscribeGroups を更新できます。

UPDATE UnsubscribeGroups SET Name = 'New Name', Description = 'New Description' WHERE Id = '1'

Delete

Id を指定することでUnsubscribeGroups から削除できます。

DELETE FROM UnsubscribeGroups WHERE Id = '1'

Columns

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

SendGrid Connector for CData Sync ビュー

Query the available Categories in SendGrid.

ビュー固有の情報

Select

このテーブルをクエリして、SendGrid で使用可能なカテゴリを取得します。

SELECT * FROM Categories

Columns

Query the available Category Stats in SendGrid.

ビュー固有の情報

Select

以下は、CategoryStats ビューをクエリする例です。

SELECT * FROM CategoryStats WHERE Name = 'news'

日付でフィルタをかけることもできます。指定しない場合は、過去1年間のデフォルト期間が適用されます。このカラムでは=、>=、<=、<、および> 演算子がサポートされています。

SELECT * FROM CategoryStats WHERE Name = 'news' AND Date > '2016-01-01' AND Date < '2016-01-30'

Columns

Query the available Global Stats in SendGrid.

ビュー固有の情報

Select

このテーブルからデータを取得する期間を指定する必要があります。指定しない場合は、過去1年間のデフォルト期間が適用されます。Date カラムは、>、<、=、<=、および>= 演算子をサポートします。

SELECT * FROM GlobalStats 

SELECT * FROM GlobalStats WHERE Date > '2016-01-01' AND Date < '2016-03-30'

Columns

Query group suppressions in SendGrid.

テーブル固有の情報

Select

以下は、GroupSuppressions テーブルをクエリする例です。

SELECT * FROM GroupSuppressions WHERE GroupId = 391

SELECT * FROM GroupSuppressions WHERE GroupId IN (391, 392, 393)

Columns

Query Global Unsubscribes in SendGrid.

ビュー固有の情報

Select

次のクエリのみがサーバーサイドで処理されます。

SQL

SELECT * FROM IPAccessManagement

Columns

List of events related to email message in SendGrid.

NOTE： E メールイベントにアクセスする場合は、SendGrid のEmail Activity History アドインを購入する必要があります。Restricted Access のキーを使用する場合は、messages.read およびemail_activity.read スコープを与える必要があります。

ビュー固有の情報

Select

• MessageId は'=' 比較演算子をサポートします。

SQL

SELECT * FROM MessageEvents WHERE MessageId = '1234'

Columns

Query Email Activities in SendGrid.

NOTE： E メールアクティビティにアクセスする場合は、SendGrid のEmail Activity History アドインを購入する必要があります。Restricted Access のキーを使用する場合は、messages.read およびemail_activity.read スコープを与える必要があります。

ビュー固有の情報

Select

Note：API は1000 レコードのみを返します。検索を制限するために、利用可能なフィルタから選択してください。

• Idは、'=,IN' 演算子をサポートします。
• Statusは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Subjectは、'=,!=,LIKE,NOT LIKE'演算子をサポートします。
• FromEmailは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• ToEmailは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Clicksは、'>,<,<=,>=,=,!=' 演算子をサポートします。
• LastEventTimeは、'>=, <=, BETWEEN' 演算子をサポートします。
• ApiKeyIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• AsmGroupIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• MarketingCampaignIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• MarketingCampaignNameは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• OriginatingIpは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• OutboundIpは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• Teammateは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。
• TemplateIdは、'=,!=,LIKE,NOT LIKE' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SQL

SELECT * FROM Messages WHERE Id = '1234'

SELECT * FROM Messages WHERE Id IN ('1234', '4567')

SELECT * FROM Messages WHERE Status = 'not_delivered'

SELECT * FROM Messages WHERE LastEventTime BETWEEN '2020-01-01' AND '2020-01-15'

Columns

Query the available Reserved Fields in SendGrid.

ビュー固有の情報

Select

このテーブルは、フィルタリングをサポートしていません。

SELECT * FROM ReservedFields

Columns

Query Browser Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByBrowser WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Browser Statistics by name.

SELECT * FROM StatsByBrowser WHERE Name = 'Firefox'

Columns

Query Client Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByClient WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Client Statistics by name.

SELECT * FROM StatsByClient WHERE Name = 'Other'

Columns

Query Device Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByDevice WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Device Statistics by name.

SELECT * FROM StatsByDevice WHERE Name = 'Phone'

Columns

Query Location Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByLocation WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Location Statistics by name.

SELECT * FROM StatsByLocation WHERE Name = 'US'

To query Location Statistics by type.

SELECT * FROM StatsByLocation WHERE Type = 'country'

Columns

Query Mailbox Provider Statistics in SendGrid.

View-Specific Information

Select

You need to specify a time span to select from this table. If you do not specify one, a default span of the past 1 year is used. The Date column supports the >, <, =, <=, and >= operators.

SELECT * FROM StatsByMailboxProvider

SELECT * FROM StatsByMailboxProvider WHERE Date > '2016-01-01' AND Date < '2016-03-30'

To query Mailbox Provider Statistics by name.

SELECT * FROM StatsByMailboxProvider WHERE Name = 'Microsoft Outlook Live'

Columns

Query Subuser Statistics in SendGrid.

ビュー固有の情報

Select

SubuserName でフィルタリングすると、特定のサブユーザーの統計情報を取得できます。

SELECT * FROM SubuserStats WHERE SubuserName = 'Example'

日付でフィルタをかけることもできます。このカラムでは=、>=、<=、<、および> 演算子がサポートされています。指定しない場合は、過去1年間のデフォルト期間が適用されます。

SELECT * FROM SubuserStats WHERE SubuserName = 'News' AND Date > '2016-01-01' AND Date < '2016-01-30'

Columns

Query the available Users in SendGrid.

ビュー固有の情報

Select

ユーザーはId によってのみフィルタできます。

SELECT * FROM Users WHERE Id = '1'

Columns

Authentication

SSL

Firewall

Proxy

Logging

Schema

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

現在の認証ユーザーのAPI キー。

解説

現在の認証ユーザーのAPI キー。これは、SendGrid Sync App を介して認証するために必須のパラメータです。

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

プロキシベースのファイアウォールで使われるプロトコル。

解説

このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

プロキシベースのファイアウォールの名前もしくはIP アドレス。

解説

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。

Sync App はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。

プロキシベースのファイアウォールのTCP ポート。

解説

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

プロキシベースのファイアウォールに認証するために使うユーザー名。

解説

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

プロキシベースのファイアウォールへの認証に使われるパスワード。

解説

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。

これは、システムプロキシ設定を使用するかどうかを示します。

解説

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。

解説

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、Sync App はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。

SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。

デフォルトで、Sync App はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。

ProxyServer プロキシが起動しているTCP ポート。

解説

HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。

ProxyServer プロキシへの認証で使われる認証タイプ。