API
オーディエンスに連絡先をインポートする
オーディエンスページの CSV インポートを API で行います。形式の正しいアドレスはまだ連絡先でなければ連絡先になり、すべてこのオーディエンスに入ります。1 回の呼び出しで最大 500 行です。それより長いリストは複数回に分けて送ってください。
POSTapi.openemail.uk/audiences/{id}/import
実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。
POST /audiences/{id}/import
オーディエンスページの CSV インポートを API で行います。形式の正しいアドレスはまだ連絡先でなければ連絡先になり、すべてこのオーディエンスに入ります。1 回の呼び出しで最大 500 行です。それより長いリストは複数回に分けて送ってください。
例
連絡先を作成するため、audiences:write と contacts:write が必要です。各行は email と、最大 200 文字の省略可能な name です。
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{ "contacts": [ { "email": "[email protected]", "name": "Grace Hopper" }, { "email": "[email protected]", "name": "Katherine Johnson" }, { "email": "not-an-address" } ]}'{ "object": "audience_import", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "created": 1, "added": 1, "skipped": 1, "invalid": ["not-an-address"]}created は新しい連絡先、added はこのオーディエンスでの新しいメンバーシップ、skipped はインポートされなかった行を数えます。invalid は形式の正しくないアドレスを送られたとおりに列挙します。新しい連絡先は manual として保存され、デフォルトオーディエンスにも参加します。
すでに連絡先であるアドレスは再利用され、重複することはなく、名前もそのまま残ります。ここでの name は空の名前を埋めるだけです。アドレス帳から削除されたアドレスは再び連絡先になり、1 回の呼び出しに同じアドレスが 2 回あっても 1 回として数えます。
再実行しても安全です。同じ呼び出しを 2 回目に送っても、何も作成されず何も追加されません。誰にも何も送られず、誰も何かに登録されることはありません。