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

Consulta os detalhes de envio.

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

*All Resource

*

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ê deixar este parâmetro vazio, os e-mails de todos os endereços de remetente serão consultados. Nota Você pode deixar AccountName, TagName e ToAddress vazios. Você pode especificar um valor para apenas um desses parâmetros por vez.	s***@example.net
ToAddress	string	Não	O endereço do destinatário. Se você deixar este parâmetro vazio, os e-mails enviados para todos os endereços de destinatário serão consultados.	b***@example.net
Status	integer	Não	O status de entrega. Se você deixar este parâmetro vazio, os e-mails em todos os status de entrega serão consultados. Valores válidos: 0: entregue com 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. O 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. O formato é yyyy-MM-dd HH:mm.	2021-04-29 00:00
TagName	string	Não	A tag do e-mail. Se você deixar este parâmetro vazio, os e-mails com todas as tags serão consultados. Ao enviar um e-mail usando SMTP, especifique o TagName e seu valor para o campo X-AliDM-Trace. Para mais informações, consulte os exemplos de rastreamento de e-mail.	EmailQuestionnaireHelioscam
Length	integer	Não	O número de resultados a serem retornados. O valor pode variar de 1 a 100.	5
NextStart	string	Não	O offset para esta solicitação, usado para paginação. Se mais resultados estiverem disponíveis, defina o parâmetro NextStart na sua próxima solicitação com este valor de retorno.	90f0243616#203#a*@example.net-1658817837#a*@example.net.247475288187
IpPoolId	string	Não	O ID do pool de endereços IP independentes.	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	Usado para paginação. Se mais resultados estiverem disponíveis, defina o parâmetro NextStart na sua próxima solicitação com este valor de retorno.	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	The delivery status. 0: delivered successfully, 2: invalid address, 3: spam, 4: failed for other reasons.	0
LastUpdateTime	string	The time when the status was last updated.	2021-04-28T17:11Z
Message	string	The detailed information about the delivery.	250 Send Mail OK
ToAddress	string	The recipient address.	b***@example.net
UtcLastUpdateTime	string	The time when the status 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 successfully. SmtpNxBox: The recipient's email server determined that the address is invalid. The address is added to the invalid address list of your account. SysOutRcptOnAccountLevelBounceList: The recipient address is in the invalid address list for your account. If you confirm that the address is valid, remove it from the list. You can also disable the invalid address list for your account. For more information about error descriptions, see Explanations of common failed_type values.	SendOk
IpPoolId	string	The ID of the independent IP address pool.	xxx
IpPoolName	string	The name of the independent IP address pool.	xxx
ConfigSetId	string	The ID of the configuration set.	xxx
ConfigSetName	string	The name of the configuration set.	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.