Campaign Standard - Pergunta de desenvolvimento da API ACS sobre criação/atualização de perfis

Descrição

Pergunta sobre a implementação da API ACS para criar/atualizar perfis usando o método descrito na documentação:  https://experienceleague.adobe.com/docs/campaign-standard/using/working-with-apis/managing-profiles/updating-profiles.html?lang=pt-BR

Há uma maneira mais simples de explicar abaixo (para referenciar um atributo cusId foi definida como a chave na tabela de perfis):

1) Ao fazer PATCH usando https://*.adobe.*/instanceURL/campaign/profileAndServicesExt/profile e incluir uma cusCustomerId, o perfil será atualizado.

2) Da mesma forma, ao usar o PATCH https://*.adobe.*/instanceURLcampaign/profileAndServicesExt/profile/@xxxxxxxxxxxx o perfil também será atualizado.

Nesse caso, o cliente não precisa usar cusId, mas precisam do perfil Pkey, mas cusId sempre serão preenchidas e observarão que sempre podem usar esse campo.

A primeira opção seria a melhor forma de simplificar a lógica.

Pergunta: como a opção 1 não está documentada, confirme se a opção 1 é compatível?

Resolução

Since cusId for uma chave comercial no perfil, esse campo poderá ser usado para recuperar a entidade.
E de fato, o PATCH também funcionará.
Isso pode ser usado, mas as seguintes limitações devem ser comunicadas:

Ao usar o campo cusId como uma chave, o campo não pode ser modificado usando um PATCH.
NÃO crie URLs para coleções.
Assim, usando o cusId O campo funcionará para recursos de perfil de nível superior (/rest/.../profile/ cusId )mas se o cliente quiser obter as assinaturas de um perfil, ele deverá passar pela REST API:

  • GET /rest/.../profile/cusId

  • GET /href/of/the/subscription/collection/returned/by/the/previous/call

Nesta página