Endpoint de uniões
Criado para:
- Desenvolvedor
As uniões (ou exibições de união) são esquemas somente leitura gerados pelo sistema que agregam os campos de todos os esquemas que compartilham a mesma classe (XDM ExperienceEvent ou XDM Individual Profile) e são habilitados para Real-Time Customer Profile.
Este documento aborda conceitos essenciais para trabalhar com sindicatos na API do registro de esquema, incluindo chamadas de amostra para várias operações. Para obter informações mais gerais sobre uniões no XDM, consulte a seção sobre uniões nas noções básicas da composição do esquema.
Campos de esquema de união
O Schema Registry inclui automaticamente três campos principais em um esquema de união: identityMap, timeSeriesEvents e segmentMembership.
Mapa de identidade
Um esquema de união identityMap é uma representação das identidades conhecidas dentro dos esquemas de registro associados da união. O mapa de identidade separa as identidades em matrizes diferentes digitadas pelo namespace. Cada identidade listada é ela mesma um objeto que contém um valor id exclusivo. Consulte a documentação do Serviço de Identidade para obter mais informações.
Eventos de série temporal
A matriz timeSeriesEvents é uma lista de eventos de série temporal relacionados aos esquemas de registro associados à união. Quando os dados do perfil são exportados para conjuntos de dados, essa matriz é incluída para cada registro. Isso é útil para vários casos de uso, como aprendizado de máquina, em que os modelos precisam de todo o histórico de comportamento de um perfil, além dos atributos de registro.
Mapa da associação de segmento
O mapa segmentMembership armazena os resultados da avaliação de uma definição de segmento. Quando trabalhos de segmento são executados com êxito usando a API de segmentação, o mapa é atualizado. O segmentMembership também armazena todos os públicos-alvo pré-avaliados que são assimilados na Experience Platform, permitindo a integração com outras soluções, como o Adobe Audience Manager. Consulte o tutorial sobre criação de públicos-alvo usando APIs para obter mais informações.
Recuperar uma lista de uniões
Ao definir a tag union em um esquema, o Schema Registry adiciona automaticamente o esquema à união para a classe em que o esquema se baseia. Se nenhuma união existir para a classe em questão, uma nova união será criada automaticamente. O $id para a união é semelhante ao $id padrão de outros recursos Schema Registry, com a única diferença sendo que é anexada por dois sublinhados e a palavra "união" (__union).
Você pode exibir uma lista de uniões disponíveis fazendo uma solicitação GET para o ponto de extremidade /tenant/unions.
Formato da API
GET /tenant/unions
Solicitação
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Accept: application/vnd.adobe.xed-id+json'
O formato da resposta depende do cabeçalho Accept enviado na solicitação. Os Accept cabeçalhos a seguir estão disponíveis para listar uniões:
Acceptapplication/vnd.adobe.xed-id+jsonapplication/vnd.adobe.xed+json$ref e allOf originais incluídos. (Limite: 300)Resposta
Uma resposta bem-sucedida retorna o status HTTP 200 (OK) e uma matriz results no corpo da resposta. Se as uniões tiverem sido definidas, os detalhes de cada união serão fornecidos como objetos dentro da matriz. Se nenhuma união tiver sido definida, o status HTTP 200 (OK) ainda será retornado, mas a matriz results estará vazia.
{
"results": [
{
"title": "XDM Individual Profile",
"$id": "https://ns.adobe.com/xdm/context/profile__union",
"meta:altId": "_xdm.context.profile__union",
"version": "1"
},
{
"title": "Property",
"$id": "https://ns.adobe.com/{TENANT_ID}/classes/19e1d8b5098a7a76e2c10a81cbc99590__union",
"meta:altId": "_{TENANT_ID}.classes.19e1d8b5098a7a76e2c10a81cbc99590__union",
"version": "1"
}
]
}
Pesquisar uma união
Você pode visualizar uma união específica executando uma solicitação GET que inclui o $id e, dependendo do cabeçalho Aceitar, alguns ou todos os detalhes da união.
NOTE/unions e /schemas para habilitá-las para uso em exportações Profile em um conjunto de dados.Formato da API
GET /tenant/unions/{UNION_ID}
GET /tenant/schemas/{UNION_ID}
{UNION_ID}$id codificado na URL da união que você deseja pesquisar. Os URIs para esquemas de união são anexados com "__union".Solicitação
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions/https%3A%2F%2Fns.adobe.com%2Fxdm%2Fcontext%2Fprofile__union \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Accept: application/vnd.adobe.xed+json; version=1'
As solicitações de pesquisa de união exigem que version seja incluído no cabeçalho Aceitar.
Os seguintes cabeçalhos Aceitar estão disponíveis para pesquisas de esquema de união:
application/vnd.adobe.xed+json; version=1$ref e allOf. Inclui títulos e descrições.application/vnd.adobe.xed-full+json; version=1$ref atributos e allOf resolvidos. Inclui títulos e descrições.Resposta
Uma resposta bem-sucedida retorna a visualização de união de todos os esquemas que implementam a classe cujo $id foi fornecido no caminho da solicitação.
O formato da resposta depende do cabeçalho Aceitar enviado na solicitação. Experimente com diferentes cabeçalhos Aceitar para comparar as respostas e determinar qual cabeçalho é melhor para o seu caso de uso.
{
"type": "object",
"description": "Union view of all schemas that extend https://ns.adobe.com/xdm/context/profile",
"allOf": [
{
"$ref": "https://ns.adobe.com/xdm/context/profile"
},
{
"$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
},
{
"$ref": "https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599"
},
{
"$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
}
],
"meta:extends": [
"https://ns.adobe.com/xdm/context/profile",
"https://ns.adobe.com/xdm/data/record",
"https://ns.adobe.com/xdm/context/identitymap",
"https://ns.adobe.com/xdm/common/extensible",
"https://ns.adobe.com/xdm/common/auditable",
"https://ns.adobe.com/xdm/context/profile-person-details",
"https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599",
"https://ns.adobe.com/xdm/context/profile-personal-details"
],
"title": "Union object for https://ns.adobe.com/xdm/context/profile",
"$id": "https://ns.adobe.com/xdm/context/profile__union",
"meta:containerId": "tenant",
"meta:class": "https://ns.adobe.com/xdm/context/profile",
"meta:altId": "_xdm.context.profile__union",
"version": "1.0",
"meta:resourceType": "unions",
"meta:registryMetadata": {}
}
Ativar um esquema para associação de união
Para que um esquema seja incluído na união para sua classe, uma marca union deve ser adicionada ao atributo meta:immutableTags do esquema. Você pode fazer isso fazendo uma solicitação PATCH para adicionar uma matriz meta:immutableTags com um único valor de sequência de caracteres de union ao esquema em questão. Consulte o manual de endpoint de esquemas para obter um exemplo detalhado.
Listar esquemas em uma união
Para ver quais esquemas fazem parte de uma união específica, você pode executar uma solicitação GET para o ponto de extremidade /tenant/schemas. Usando o parâmetro de consulta property, você pode configurar a resposta para retornar apenas esquemas contendo um campo meta:immutableTags e um meta:class igual à classe cuja união você está acessando.
Formato da API
GET /tenant/schemas?property=meta:immutableTags==union&property=meta:class=={CLASS_ID}
{CLASS_ID}$id da classe cujos esquemas habilitados para união você deseja listar.Solicitação
A solicitação a seguir recupera uma lista de todos os esquemas que fazem parte da união para a classe XDM Individual Profile.
curl -X GET \
'https://platform.adobe.io/data/foundation/schemaregistry/tenant/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile' \
-H 'Accept: application/vnd.adobe.xed-id+json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
O formato da resposta depende do cabeçalho Accept enviado na solicitação. Os Accept cabeçalhos a seguir estão disponíveis para listar esquemas:
Acceptapplication/vnd.adobe.xed-id+jsonapplication/vnd.adobe.xed+json$ref e allOf originais incluídos. (Limite: 300)Resposta
Uma resposta bem-sucedida retorna uma lista filtrada de esquemas, contendo apenas aqueles que pertencem à classe especificada e que foram ativados para associação de união. Lembre-se de que, ao usar vários parâmetros de consulta, uma relação AND é presumida.
{
"results": [
{
"title": "Schema 1",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/142afb78d8b368a5ba97a6cc8fc7e033",
"meta:altId": "_{TENANT_ID}.schemas.142afb78d8b368a5ba97a6cc8fc7e033",
"version": "1.2"
},
{
"title": "Schema 2",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/e7297a6ddfc7812ab3a7b504a1ab98da",
"meta:altId": "_{TENANT_ID}.schemas.e7297a6ddfc7812ab3a7b504a1ab98da",
"version": "1.5"
},
{
"title": "Schema 3",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/50f960bb810e99a21737254866a477bf",
"meta:altId": "_{TENANT_ID}.schemas.50f960bb810e99a21737254866a477bf",
"version": "1.2"
},
{
"title": "Schema 4",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/a39655ca8ea3d5c1f36a463b45fccca8",
"meta:altId": "_{TENANT_ID}.schemas.a39655ca8ea3d5c1f36a463b45fccca8",
"version": "1.1"
},
{
"title": "Schema 5",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/c063fac45c6d6285ef33b0e2af09f633",
"meta:altId": "_{TENANT_ID}.schemas.c063fac45c6d6285ef33b0e2af09f633",
"version": "1.2"
},
{
"title": "Schema 6",
"$id": "https://ns.adobe.com/{TENANT_ID}/schemas/dfebb19b93827b70bbad006137812537",
"meta:altId": "_{TENANT_ID}.schemas.dfebb19b93827b70bbad006137812537",
"version": "1.7"
}
],
"_links": {
"global_schemas": {
"href": "https://platform.adobe.io/data/foundation/schemaregistry/global/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile"
}
}
}