Associar usuários aos endpoints do Amazon Pinpoint

Para adicionar um usuário a um endpoint, use o comando update-endpoint. Para o parâmetro --endpoint-request, você pode definir um novo endpoint, que pode incluir um usuário. Ou, para atualizar um endpoint existente, você pode fornecer apenas os atributos que deseja alterar. O exemplo a seguir adiciona um usuário a um endpoint existente fornecendo apenas os atributos do usuário:

$ aws pinpoint update-endpoint \
> --application-id application-id \
> --endpoint-id endpoint-id \
> --endpoint-request file://endpoint-request-file.json

Em que:

O comando update-endpoint de exemplo usa um arquivo JSON como o argumento para o parâmetro --endpoint-request. Esse arquivo contém uma definição de usuário, como a seguinte:

{ 
    "User":{ 
        "UserId":"example_user",
        "UserAttributes":{ 
            "FirstName":["Wang"],
            "LastName":["Xiulan"],
            "Gender":["Female"],
            "Age":["39"]
        }
    }
}

Para obter os atributos que podem ser usados para definir um usuário, consulte o objeto User no esquema EndpointRequest na Referência da API do Amazon Pinpoint.

Para adicionar um usuário a um endpoint, inicialize um objeto EndpointRequest e passe-o para o método updateEndpoint do cliente do AmazonPinpoint. Você pode usar esse objeto para definir um novo endpoint, que pode incluir um usuário. Ou, para atualizar um endpoint existente, você pode atualizar apenas as propriedade que deseja alterar. O exemplo a seguir adiciona um usuário a um endpoint existente adicionando um objeto EndpointUser ao objeto EndpointRequest:

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.EndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.EndpointUser;
import software.amazon.awssdk.services.pinpoint.model.ChannelType;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

    public static void updatePinpointEndpoint(PinpointClient pinpoint, String applicationId, String endPointId) {
        try {
            List<String> wangXiList = new ArrayList<>();
            wangXiList.add("cooking");
            wangXiList.add("running");
            wangXiList.add("swimming");

            Map myMapWang = new HashMap<>();
            myMapWang.put("interests", wangXiList);

            List<String> myNameWang = new ArrayList<>();
            myNameWang.add("Wang ");
            myNameWang.add("Xiulan");

            Map wangName = new HashMap<>();
            wangName.put("name", myNameWang);

            EndpointUser wangMajor = EndpointUser.builder()
                    .userId("example_user_10")
                    .userAttributes(wangName)
                    .build();

            // Create an EndpointBatchItem object for Mary Major.
            EndpointRequest wangXiulanEndpoint = EndpointRequest.builder()
                    .channelType(ChannelType.EMAIL)
                    .address("wang_xiulan@example.com")
                    .attributes(myMapWang)
                    .user(wangMajor)
                    .build();

            // Adds multiple endpoint definitions to a single request object.
            UpdateEndpointRequest endpointList = UpdateEndpointRequest.builder()
                    .applicationId(applicationId)
                    .endpointRequest(wangXiulanEndpoint)
                    .endpointId(endPointId)
                    .build();

            UpdateEndpointResponse result = pinpoint.updateEndpoint(endpointList);
            System.out.format("Update endpoint result: %s\n", result.messageBody().message());

        } catch (PinpointException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }

Para adicionar um usuário a um endpoint, envie uma solicitação PUT para o recurso Endpoint no seguinte URI:

/v1/apps/application-id/endpoints/endpoint-id

Em que:

Em sua solicitação, inclua os cabeçalhos necessários e forneça o JSON EndpointRequest como o corpo. O corpo da solicitação pode definir um novo endpoint, que pode incluir um usuário. Ou, para atualizar um endpoint existente, você pode fornecer apenas os atributos que deseja alterar. O exemplo a seguir adiciona um usuário a um endpoint existente fornecendo apenas os atributos do usuário:

PUT /v1/apps/application_id/endpoints/example_endpoint HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
X-Amz-Date: 20180415T182538Z
Content-Type: application/json
Accept: application/json
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20180501/us-east-1/mobiletargeting/aws4_request, SignedHeaders=accept;content-length;content-type;host;x-amz-date, Signature=c25cbd6bf61bd3b3667c571ae764b9bf2d8af61b875cacced95d1e68d91b4170
Cache-Control: no-cache

{ 
    "User":{ 
        "UserId":"example_user",
        "UserAttributes":{ 
            "FirstName":"Wang",
            "LastName":"Xiulan",
            "Gender":"Female",
            "Age":"39"
        }
    }
}

Se a solicitação for bem-sucedida, você receberá uma resposta como a seguinte:

{
    "RequestID": "67e572ed-41d5-11e8-9dc5-db288f3cbb72",
    "Message": "Accepted"
}