Global Unsubscribes

Global Unsubscribes

Global Unsubscribesはいかなるメールも送信しないようにするためのアドレスリストです。

List all globally unsubscribed email addresses [GET]

URI引数 必須 条件 説明
start_time No timestamp 配信停止された時刻の範囲をUNIXタイム形式で指定します。
Example: 1443651141
end_time No timestamp 配信停止された時刻の範囲をUNIXタイム形式で指定します。
Example: 1443651154
limit No integer 結果を取得する件数を制限します。
Example: 10
offset No integer 結果を取得する位置のオフセットを指定します。
Example: 0

Request

1
GET https://api.sendgrid.com/v3/suppression/unsubscribes?start_time={start_time}&end_time={end_time}&limit=10&offset=0 HTTP/1.1

Response

1
2
3
4
5
6
7
8
9
10
11
HTTP/1.1 200
[
  {
    "created": 1443651141,
    "email": "user1@example.com"
  },
  {
    "created": 1443651154,
    "email": "exampexample@example.comom"
  }
]

Add email addresses to the Global Unsubscribes collection [POST]

Global Unsubscribesへのアドレス追加

Request

1
POST https://api.sendgrid.com/v3/asm/suppressions/global HTTP/1.1
Request Body
1
2
3
4
5
6
{
  "recipient_emails": [
    "test1@example.com",
    "test2@example.com"
  ]
}

Response

1
2
3
4
5
6
7
HTTP/1.1 201
{
  "recipient_emails": [
    "test1@example.com",
    "test2@example.com"
  ]
}

Determine if an email address belongs to the Global Unsubscribes collection [GET]

Global Unsubscribesに宛先アドレスが存在するか確認する
URI引数 必須 条件 説明
email Yes string 対象メールアドレス
Example: test@test.com

Request

1
GET https://api.sendgrid.com/v3/asm/suppressions/global/{email} HTTP/1.1

Response

1
2
3
4
HTTP/1.1 200
{
  "recipient_email": "{email}"
}
指定したアドレスがGlobal Unsubscribesに含まれていない場合の応答は次のとおりです:
URI引数 必須 条件 説明
email Yes string 対象メールアドレス
Example: test@test.com

Request

1
GET https://api.sendgrid.com/v3/asm/suppressions/global/{email} HTTP/1.1

Response

1
2
3
HTTP/1.1 200
{
}

Delete a Global Suppression [DELETE]

グローバルサプレッショングループから宛先アドレスを削除します。
URI引数 必須 条件 説明
email Yes string 対象メールアドレス
Example: test@test.com

Request

1
DELETE https://api.sendgrid.com/v3/asm/suppressions/global/{email} HTTP/1.1

Response

1
HTTP/1.1 204

Remove multiple email addresses from the Global Unsubscribes collection [DELETE]

emails 配列には最大500アドレスが入ります

Request

1
DELETE https://api.sendgrid.com/v3/suppression/unsubscribes HTTP/1.1
Request Body
1
2
3
4
5
6
{
  "emails": [
    "test1@example.com",
    "test2@example.com"
  ]
}

Response

1
HTTP/1.1 204

Remove all email addresses from the Global Unsubscribes collection [DELETE]

Request

1
DELETE https://api.sendgrid.com/v3/suppression/unsubscribes HTTP/1.1
Request Body
1
2
3
{
  "delete_all": true
}

Response

1
HTTP/1.1 204