Todos os produtos
Search

Este produto

    Direct Mail:GetTrackList

    Central de documentação

    Direct Mail:GetTrackList

    Última atualização: Oct 20, 2026

    Obtém dados de rastreamento e envio de e-mails.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    dm:GetTrackList

    list

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    StartTime

    string

    Sim

    O horário de início. O horário não pode ser anterior a 30 dias. Formato: yyyy-MM-dd.

    2019-09-29
    EndTime

    string

    Sim

    O horário de término. O intervalo de tempo entre o horário de início e o horário de término não pode exceder 7 dias. Formato: yyyy-MM-dd.

    2019-09-29
    Total

    string

    Não

    [Obsoleto]

    **[Deprecated]**
    Offset

    string

    Não

    [Obsoleto] O valor é 0 para a primeira consulta e fixado em 1 para consultas subsequentes. Um valor de 1 indica paginação em ordem cronológica.

    **[Deprecated]**
    PageSize

    string

    Não

    O número de entradas por página.

    10
    OffsetCreateTime

    string

    Não

    [Obsoleto] Usado para paginação. Não defina este parâmetro para a primeira consulta. Para consultas subsequentes, defina este parâmetro com o valor de OffsetCreateTime na resposta anterior.

    **[Deprecated]**
    OffsetCreateTimeDesc

    string

    Não

    [Obsoleto]

    **[Deprecated]**
    PageNumber

    string

    Não

    O número da página.

    1
    AccountName

    string

    Não

    O endereço do remetente.\n\n> Se você não especificar este parâmetro, todos os endereços serão consultados. Se TagName for especificado, este parâmetro não poderá estar vazio.

    test@example.com
    TagName

    string

    Não

    O nome da tag.

    tagname
    DedicatedIpPoolId

    string

    Não

    O ID do pool de endereços IP dedicados. Este parâmetro está disponível para usuários com endereços IP dedicados.\n\nSe você não especificar este parâmetro, os dados de todos os pools de endereços IP dedicados serão consultados.

    xxx
    DedicatedIp

    string

    Não

    O endereço IP dedicado. Este parâmetro está disponível para usuários com endereços IP dedicados.\n\nSe você não especificar este parâmetro, os dados de todos os endereços IP dedicados serão consultados.

    xxx.xxx.xxx.xxx
    Esp

    string

    Não

    O Provedor de Serviços de E-mail (ESP). Este parâmetro está disponível para usuários com endereços IP dedicados. Valores válidos:\n- gmail.com\n- yahoo.com\n- outlook.com\n- icloud.com\n- others: outros ESPs não listados acima.\n\nSe você não especificar este parâmetro, os dados de todos os ESPs serão consultados.

    gmail.com
    ConfigSetId

    string

    Não

    O ID do conjunto de configurações.

    xxx
    Domain

    string

    Não

    O nome de domínio do remetente.

    dmdomain.com

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    OffsetCreateTimeDesc

    string

    [Obsoleto]

    **[Deprecated]**
    OffsetCreateTime

    string

    [Obsoleto] Usado para paginação. Não defina este parâmetro para a primeira consulta. Para consultas subsequentes, defina este parâmetro com o valor de OffsetCreateTime na resposta anterior.

    **[Deprecated]**
    RequestId

    string

    O ID da solicitação.

    10A1AD70-E48E-476D-98D9-39BD92193837
    PageNo

    integer

    O número da página atual.

    1
    PageSize

    integer

    O número de entradas por página.

    10
    Total

    integer

    O número total de entradas.

    100
    TotalPages

    integer

    O número total de páginas.

    2
    data

    object

    stat

    array<object>

    Os registros de dados de rastreamento.

    object

    As estatísticas de rastreamento de e-mails.

    RcptClickRate

    string

    A taxa de cliques (CTR).

    0
    RcptUniqueOpenCount

    string

    O número de aberturas exclusivas.

    0
    RcptClickCount

    string

    O número de cliques.

    0
    RcptUniqueClickCount

    string

    O número de cliques exclusivos.

    0
    CreateTime

    string

    O horário de criação. O horário está no formato ISO 8601 UTC com precisão de minutos.

    2019-09-29T13:28Z
    RcptUniqueOpenRate

    string

    A taxa de abertura exclusiva.

    0
    RcptUniqueClickRate

    string

    A taxa de cliques exclusiva.

    0
    TotalNumber

    string

    O número total de entradas.

    0
    RcptOpenRate

    string

    A taxa de abertura.

    0
    RcptOpenCount

    string

    O número de aberturas.

    0

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "OffsetCreateTimeDesc": "（本字段已废弃）",
  "OffsetCreateTime": "（本字段已废弃）",
  "RequestId": "10A1AD70-E48E-476D-98D9-39BD92193837",
  "PageNo": 1,
  "PageSize": 10,
  "Total": 100,
  "TotalPages": 2,
  "data": {
    "stat": [
      {
        "RcptClickRate": "0",
        "RcptUniqueOpenCount": "0",
        "RcptClickCount": "0",
        "RcptUniqueClickCount": "0",
        "CreateTime": "2019-09-29T13:28Z",
        "RcptUniqueOpenRate": "0",
        "RcptUniqueClickRate": "0",
        "TotalNumber": "0",
        "RcptOpenRate": "0",
        "RcptOpenCount": "0"
      }
    ]
  }
}

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.