All Products
Search

This Product

    Direct Mail:SenderStatisticsDetailByParam

    Document Center

    Direct Mail:SenderStatisticsDetailByParam

    Last Updated:Jun 10, 2026

    Mengkueri detail pengiriman.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dm:SenderStatisticsDetailByParam

    list

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AccountName

    string

    No

    Alamat pengirim. Jika Anda mengosongkan parameter ini, email dari semua alamat pengirim akan dikueri.

    Catatan

    Anda dapat mengosongkan AccountName, TagName, dan ToAddress. Anda hanya dapat menentukan nilai untuk satu parameter ini dalam satu waktu.

    s***@example.net
    ToAddress

    string

    No

    Alamat penerima. Jika Anda mengosongkan parameter ini, email yang dikirim ke semua alamat penerima akan dikueri.

    b***@example.net
    Status

    integer

    No

    Status pengiriman. Jika Anda mengosongkan parameter ini, email dengan semua status pengiriman akan dikueri. Nilai valid:

    • 0: berhasil dikirim

    • 2: alamat tidak valid

    • 3: spam

    • 4: gagal.

    0
    StartTime

    string

    No

    Pengatur waktu mulai. Rentang pengatur waktu antara pengatur waktu mulai dan pengatur waktu akhir tidak boleh melebihi 30 hari. Format adalah yyyy-MM-dd HH:mm.

    2021-04-28 00:00
    EndTime

    string

    No

    Pengatur waktu akhir. Rentang pengatur waktu antara pengatur waktu mulai dan pengatur waktu akhir tidak boleh melebihi 30 hari. Format adalah yyyy-MM-dd HH:mm.

    2021-04-29 00:00
    TagName

    string

    No

    Tag email. Jika Anda mengosongkan parameter ini, email dengan semua tag akan dikueri. Saat Anda mengirim email menggunakan SMTP, tentukan TagName dan nilainya untuk bidang X-AliDM-Trace. Untuk informasi lebih lanjut, lihat contoh untuk pelacakan email.

    EmailQuestionnaireHelioscam
    Length

    integer

    No

    Jumlah hasil yang akan dikembalikan. Nilainya dapat berkisar dari 1 hingga 100.

    5
    NextStart

    string

    No

    Offset untuk permintaan ini, digunakan untuk paging. Jika hasil lainnya tersedia, atur parameter NextStart di permintaan berikutnya Anda ke nilai kembali ini.

    90f0243616#203#a***@example.net-1658817837#a***@example.net.247475288187
    IpPoolId

    string

    No

    ID kolam alamat IP independen.

    e42a4d8e-66e0-4ea3-88aa-74c66c661cef
    ConfigSetId

    string

    No

    ID set konfigurasi.

    95437e39-5433-4c6c-8b66-0c4eac2f4d97

    Elemen respons

    Element

    Type

    Description

    Example

    object

    NextStart

    string

    Used for paging. If more results are available, set the `NextStart` parameter in your next request to this return value.

    90f0243616#203#a***@example.net-1658817689#a***@example.net.247141122178
    RequestId

    string

    The request ID.

    B5AB8EBB-EE64-4BB2-B085-B92CC5DEDC41
    data

    object

    mailDetail

    array<object>

    The detailed records.

    object

    Status

    integer

    The delivery status. `0`: Success. `2`: Invalid address. `3`: Spam. `4`: Other failures.

    0
    LastUpdateTime

    string

    The time when the record was last updated.

    2021-04-28T17:11Z
    Message

    string

    The detailed delivery information.

    250 Send Mail OK
    ToAddress

    string

    The recipient address.

    b***@example.net
    UtcLastUpdateTime

    string

    The time when the record was last updated, in UTC format.

    1619601108
    AccountName

    string

    The sender address.

    s***@example.net
    Subject

    string

    The email subject.

    test subject
    ErrorClassification

    string

    The detailed classification of the error:

    • SendOk: The email was delivered.

    • SmtpNxBox: The recipient's email system identified the address as invalid. The address is added to your account-level invalid address list.

    • SysOutRcptOnAccountLevelBounceList: The address hit the account-level invalid address list. If you confirm that the address is valid, you can remove it on the Invalid Addresses page or choose to disable the account-level invalid address list.

    For more information about error descriptions, see Explanations of common failed_type values.

    SendOk
    IpPoolId

    string

    The ID of the dedicated IP address pool.

    xxx
    IpPoolName

    string

    The name of the dedicated IP address pool.

    xxx
    ConfigSetId

    string

    The ID of the configuration set.

    xxx
    ConfigSetName

    string

    The name of the configuration set.

    xxx

    Contoh

    Respons sukses

    JSONformat

    {
  "NextStart": "90f0243616#203#a***@example.net-1658817689#a***@example.net.247141122178",
  "RequestId": "B5AB8EBB-EE64-4BB2-B085-B92CC5DEDC41",
  "data": {
    "mailDetail": [
      {
        "Status": 0,
        "LastUpdateTime": "2021-04-28T17:11Z",
        "Message": "250 Send Mail OK",
        "ToAddress": "b***@example.net",
        "UtcLastUpdateTime": "1619601108",
        "AccountName": "s***@example.net",
        "Subject": "test subject",
        "ErrorClassification": "SendOk",
        "IpPoolId": "xxx",
        "IpPoolName": "xxx",
        "ConfigSetId": "xxx",
        "ConfigSetName": "xxx"
      }
    ]
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.