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

Obtém os detalhes de 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:SenderStatisticsDetailByParam

list

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AccountName	string	Não	O endereço do remetente. Se você não especificar este parâmetro, todos os endereços de remetente serão consultados. Nota Você pode deixar AccountName, TagName e ToAddress sem especificar. Se você especificar qualquer um desses parâmetros, poderá passar apenas um deles. Não é possível passar uma combinação de dois ou mais parâmetros.	s***@example.net
ToAddress	string	Não	O endereço do destinatário. Se você não especificar este parâmetro, todos os endereços de destinatário serão consultados.	b***@example.net
Status	integer	Não	O resultado da entrega. Se você não especificar este parâmetro, todos os status serão consultados. Valores válidos: 0: Sucesso. 2: Endereço inválido. 3: Spam. 4: Falha.	0
StartTime	string	Não	A hora de início. O intervalo de tempo entre a hora de início e a hora de término não pode exceder 30 dias. Formato: yyyy-MM-dd HH:mm.	2021-04-28 00:00
EndTime	string	Não	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 30 dias. Formato: yyyy-MM-dd HH:mm.	2021-04-29 00:00
TagName	string	Não	A tag de e-mail. Se você não especificar este parâmetro, todas as tags serão consultadas. Ao enviar e-mails por SMTP, consulte o exemplo de rastreamento de e-mail para especificar o campo TagName e seu valor correspondente para o campo X-AliDM-Trace.	EmailQuestionnaireHelioscam
Length	integer	Não	Especifica o número de resultados a serem retornados para a solicitação atual. Valores válidos: 1 a 100.	5
NextStart	string	Não	O deslocamento para paginação. Se mais resultados estiverem disponíveis, defina o valor retornado como o parâmetro NextStart na próxima solicitação.	90f0243616#203#a*@example.net-1658817837#a*@example.net.247475288187
IpPoolId	string	Não	O ID do pool de endereços IP dedicados.	e42a4d8e-66e0-4ea3-88aa-74c66c661cef
ConfigSetId	string	Não	O ID do conjunto de configurações.	95437e39-5433-4c6c-8b66-0c4eac2f4d97

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextStart	string	O deslocamento para paginação. Se mais resultados estiverem disponíveis, defina o valor retornado como o parâmetro NextStart na próxima solicitação.	90f0243616#203#a*@example.net-1658817689#a*@example.net.247141122178
RequestId	string	O ID da solicitação.	B5AB8EBB-EE64-4BB2-B085-B92CC5DEDC41
data	object
mailDetail	array<object>	Os registros detalhados.
	object
Status	integer	O status de entrega. Valores válidos: 0 (Sucesso), 2 (Endereço inválido), 3 (Spam) e 4 (Outras falhas).	0
LastUpdateTime	string	A hora de atualização no formato UTC ISO 8601, com precisão de minutos.	2021-04-28T17:11Z
Message	string	Os detalhes da entrega.	250 Send Mail OK
ToAddress	string	O endereço do destinatário.	b***@example.net
UtcLastUpdateTime	string	A hora de atualização no formato UTC.	1619601108
AccountName	string	O endereço do remetente.	s***@example.net
Subject	string	O assunto do e-mail.	test subject
ErrorClassification	string	A classificação detalhada da causa do erro. Valores válidos: SendOk: Entrega bem-sucedida. SmtpNxBox: O sistema destinatário identifica o endereço como inválido e o endereço é adicionado à sua lista de endereços inválidos no nível da conta. SysOutRcptOnAccountLevelBounceList: O endereço atinge a lista de endereços inválidos no nível da conta. Se você confirmar que o endereço é válido, poderá excluí-lo da página da lista de endereços inválidos ou optar por não ativar a lista de endereços inválidos no nível da conta. Para mais descrições de erros, consulte Explicações dos valores comuns de failed_type.	SendOk
IpPoolId	string	O ID do pool de endereços IP dedicados.	xxx
IpPoolName	string	O nome do pool de endereços IP dedicados.	xxx
ConfigSetId	string	O ID do conjunto de configurações.	xxx
ConfigSetName	string	O nome do conjunto de configurações.	xxx

Exemplos

Resposta de sucesso

JSON formato

{
  "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"
      }
    ]
  }
}

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.