GetTrackListByMailFromAndTagName - Direct Mail: Central de Documentação do Alibaba Cloud

Obtém dados de rastreamento de e-mail que atendem às condições especificadas. [parameters.0.schema.description](Este campo está obsoleto)

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:GetTrackListByMailFromAndTagName

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Total	string	Não	(This field is deprecated)	(This field is deprecated.)
StartTime	string	Sim	A hora de início. O horário não pode ser anterior a 30 dias atrás. O formato é yyyy-MM-dd.	2019-09-29
EndTime	string	Sim	A hora de término. O intervalo de tempo entre a hora de início e a hora de término não pode exceder 15 dias. O formato é yyyy-MM-dd.	2019-09-29
Offset	string	Não	O valor é 0 para a primeira consulta e 1 para as consultas subsequentes. Um valor de 1 indica uma consulta paginada em ordem cronológica. (Este campo está obsoleto)	(This field is deprecated.)
PageSize	string	Não	O número de entradas por página.	10
OffsetCreateTime	string	Não	Usado para paginação. Não defina este parâmetro para a primeira consulta. Para consultas subsequentes, defina este parâmetro com o valor OffsetCreateTime da resposta anterior. (Este campo está obsoleto) [_single.params.OffsetCreateTimeDesc.desc](Este campo está obsoleto) [parameters.6.schema.description](Este campo está obsoleto)	(This field is deprecated.)
OffsetCreateTimeDesc	string	Não	(This field is deprecated)	(This field is deprecated.)
PageNumber	string	Não	O número da página atual.	1
AccountName	string	Não	O endereço do remetente. Nota Se você deixar este parâmetro vazio, os dados de todos os endereços serão retornados. Este parâmetro é obrigatório se você especificar TagName.	e-service@amegroups.cn
TagName	string	Não	A tag de e-mail. Se você deixar este parâmetro vazio, os dados de todas as tags serão retornados.	Subscription
DedicatedIpPoolId	string	Não	O ID do pool de IPs dedicados. Este parâmetro está disponível apenas para usuários de IPs dedicados. Se você não especificar este parâmetro, os dados de todos os pools de IPs serão retornados.	xxx
DedicatedIp	string	Não	O endereço IP dedicado. Este parâmetro está disponível apenas para usuários de IPs dedicados. Se você não especificar este parâmetro, os dados de todos os IPs serão retornados.	xxx.xxx.xxx.xxx
Esp	string	Não	O Provedor de Serviços de E-mail (ESP). Este parâmetro está disponível apenas para usuários de IPs dedicados. Valores válidos: gmail.com yahoo.com outlook.com icloud.com others (dados para ESPs diferentes dos listados acima) Se você não especificar este parâmetro, os dados de todos os ESPs serão retornados.	gmail.com
ConfigSetId	string	Não	O ID do conjunto de configurações.	xxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	10A1AD70-E48E-476D-98D9-39BD92193837
OffsetCreateTime	string	Usado para paginação. Não defina este parâmetro para a primeira consulta. Para consultas subsequentes, defina este parâmetro com o valor OffsetCreateTime da resposta anterior. (Este campo está obsoleto)	(This field is deprecated.)
PageNo	integer	O número da página atual.	1
PageSize	integer	O número de entradas por página. [_single.resp.200.props.Total.desc](Este campo está obsoleto) [_single.resp.200.props.OffsetCreateTimeDesc.desc](Este campo está obsoleto) [responses.200.schema.properties.Total.description](Este campo está obsoleto) [responses.200.schema.properties.OffsetCreateTimeDesc.description](Este campo está obsoleto)	20
Total	integer	(This field is deprecated)	4
OffsetCreateTimeDesc	string	(This field is deprecated)	(This field is deprecated.)
TrackList	object
Stat	array<object>	Os registros de dados de rastreamento.
	object
RcptClickRate	string	The click-through rate.	0
RcptUniqueOpenCount	string	The number of unique opens.	0
RcptClickCount	string	The number of clicks.	0
RcptUniqueClickCount	string	The number of unique clicks.	0
CreateTime	string	The time when the record was created.	2025-01-11T10:11Z
RcptUniqueOpenRate	string	The unique open rate.	0
RcptUniqueClickRate	string	The unique click-through rate.	0
TotalNumber	string	The total number.	0
RcptOpenRate	string	The open rate.	0
RcptOpenCount	string	The number of opens.	0
TotalPages	string	O número total de páginas.	2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "10A1AD70-E48E-476D-98D9-39BD92193837",
  "OffsetCreateTime": "(This field is deprecated.)",
  "PageNo": 1,
  "PageSize": 20,
  "Total": 4,
  "OffsetCreateTimeDesc": "(This field is deprecated.)",
  "TrackList": {
    "Stat": [
      {
        "RcptClickRate": "0",
        "RcptUniqueOpenCount": "0",
        "RcptClickCount": "0",
        "RcptUniqueClickCount": "0",
        "CreateTime": "2025-01-11T10:11Z",
        "RcptUniqueOpenRate": "0",
        "RcptUniqueClickRate": "0",
        "TotalNumber": "0",
        "RcptOpenRate": "0",
        "RcptOpenCount": "0"
      }
    ]
  },
  "TotalPages": "2"
}

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.