As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitoramento de suas estatísticas de uso usando a API do Amazon SES
<a name="monitor-sending-activity-api"></a>

A API do Amazon SES fornece a operação `GetSendStatistics`, que retorna informações sobre seu uso do serviço. Recomendamos que você verifique regularmente suas estatísticas de envio, para que possa fazer ajustes, se necessário.

Quando você chama a operação `GetSendStatistics`, recebe uma lista de pontos de dados que representa as duas últimas semanas de sua atividade de envio. Cada ponto de dados na lista representa 15 minutos de atividade e contém as seguintes informações desse período:
+ O número de devoluções definitivas
+ O número de reclamações
+ O número de tentativas de entrega (corresponde ao número de e-mails que você enviou)
+ O número de tentativas de envio rejeitadas
+ Um carimbo de data e hora do período de análise

Para obter uma descrição detalhada da operação `GetSendStatistics`, consulte a [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).

Nesta seção, você encontrará os seguintes tópicos:
+ [Chamando a operação `GetSendStatistics` da API usando o AWS CLI](#monitor-sending-activity-api-cli)
+ [Chamar a operação `GetSendStatistics` de forma programática](#monitor-sending-activity-api-sdk)

## Chamando a operação `GetSendStatistics` da API usando o AWS CLI
<a name="monitor-sending-activity-api-cli"></a>

A maneira mais fácil de chamar a operação da API `GetSendStatistics` é usar a [AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).

**Para chamar a operação `GetSendStatistics` da API usando o AWS CLI**

1. Se você ainda não tiver feito isso, instale a AWS CLI. Para obter mais informações, consulte "[Instalando o AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)" no *Guia AWS Command Line Interface do usuário*.

1. Se você ainda não tiver feito isso, configure o AWS CLI para usar suas AWS credenciais. Para obter mais informações, consulte "[Configurando o AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)" no *Guia do AWS Command Line Interface usuário*.

1. Na linha de comando, execute o seguinte comando:

   ```
   aws ses get-send-statistics
   ```

   Se o AWS CLI estiver configurado corretamente, você verá uma lista de estatísticas de envio no formato JSON. Cada objeto JSON inclui estatísticas de envio agregadas para um período de 15 minutos.

## Chamar a operação `GetSendStatistics` de forma programática
<a name="monitor-sending-activity-api-sdk"></a>

Você também pode chamar a `GetSendStatistics` operação usando AWS SDKs o. Esta seção inclui exemplos de código AWS SDKs para Go, PHP, Python e Ruby. Escolha um dos seguintes links para visualizar exemplos de código da linguagem:
+ [Exemplo de código do AWS SDK para Go](#code-example-getsendstatistics-golang)
+ [Exemplo de código do AWS SDK para PHP](#code-example-getsendstatistics-php)
+ [Exemplo de código do AWS SDK para Python (Boto)](#code-example-getsendstatistics-python)
+ [Exemplo de código do AWS SDK para Ruby](#code-example-getsendstatistics-ruby)

**nota**  
Esses exemplos de código pressupõem que você criou um arquivo de credenciais AWS compartilhado que contém sua ID de chave de AWS acesso, sua chave de acesso AWS secreta e sua AWS região preferida. Para obter mais informações, consulte [Credenciais e arquivos de configuração compartilhados](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).

### Chamando `GetSendStatistics` usando o AWS SDK para Go
<a name="code-example-getsendstatistics-golang"></a>

```
 1. package main
 2.     
 3. import (
 4.     "fmt"
 5.     
 6.     //go get github.com/aws/aws-sdk-go/...
 7.     "github.com/aws/aws-sdk-go/aws"
 8.     "github.com/aws/aws-sdk-go/aws/session"
 9.     "github.com/aws/aws-sdk-go/service/ses"
10.     "github.com/aws/aws-sdk-go/aws/awserr"
11. )
12.     
13. const (
14.     // Replace us-west-2 with the AWS Region you're using for Amazon SES.
15.     AwsRegion = "{{us-west-2}}"
16. )
17.     
18. func main() {
19.     
20.     // Create a new session and specify an AWS Region.
21.     sess, err := session.NewSession(&aws.Config{
22.         Region:aws.String(AwsRegion)},
23.     )
24.     
25.     // Create an SES client in the session.
26.     svc := ses.New(sess)
27.     input := &ses.GetSendStatisticsInput{}
28.     
29.     result, err := svc.GetSendStatistics(input)
30.     
31.     // Display error messages if they occur.
32.     if err != nil {
33.         if aerr, ok := err.(awserr.Error); ok {
34.             switch aerr.Code() {
35.             default:
36.                 fmt.Println(aerr.Error())
37.             }
38.         } else {
39.             // Print the error, cast err to awserr.Error to get the Code and
40.             // Message from an error.
41.             fmt.Println(err.Error())
42.         }
43.         return
44.     }
45.     
46.     fmt.Println(result)
47. }
```

### Chamando `GetSendStatistics` usando o AWS SDK para PHP
<a name="code-example-getsendstatistics-php"></a>

```
 1. <?php
 2. 
 3. // Replace path_to_sdk_inclusion with the path to the SDK as described in 
 4. // http://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.html
 5. define('REQUIRED_FILE','{{path_to_sdk_inclusion}}');
 6.                                                   
 7. // Replace us-west-2 with the AWS Region you're using for Amazon SES.
 8. define('REGION','{{us-west-2}}'); 
 9. 
10. require REQUIRED_FILE;
11. 
12. use Aws\Ses\SesClient;
13. 
14. $client = SesClient::factory(array(
15.     'version'=> 'latest',     
16.     'region' => REGION
17. ));
18. 
19. try {
20.      $result = $client->getSendStatistics([]);
21. 	 echo($result);
22. } catch (Exception $e) {
23.      echo($e->getMessage()."\n");
24. }
25. 
26. ?>
```

### Chamando `GetSendStatistics` usando o AWS SDK para Python (Boto)
<a name="code-example-getsendstatistics-python"></a>

```
 1. import boto3 #pip install boto3
 2. import json
 3. from botocore.exceptions import ClientError
 4. 
 5. client = boto3.client('ses')
 6. 
 7. try:
 8.     response = client.get_send_statistics(
 9. )
10. except ClientError as e:
11.     print(e.response['Error']['Message'])
12. else:
13.     print(json.dumps(response, indent=4, sort_keys=True, default=str))
```

### Chamando `GetSendStatistics` usando o AWS SDK para Ruby
<a name="code-example-getsendstatistics-ruby"></a>

```
 1. require 'aws-sdk' # gem install aws-sdk
 2. require 'json'
 3. 
 4. # Replace us-west-2 with the AWS Region you're using for Amazon SES.
 5. awsregion = "{{us-west-2}}"
 6. 
 7. # Create a new SES resource and specify a region
 8. ses = Aws::SES::Client.new(region: awsregion)
 9. 
10. begin
11. 
12.   resp = ses.get_send_statistics({
13.   })
14.   puts JSON.pretty_generate(resp.to_h)
15. 
16. # If something goes wrong, display an error message.
17. rescue Aws::SES::Errors::ServiceError => error
18.   puts error
19. 
20. end
```