Schema Registry Manual da API

O Schema Registry é usado para acessar a Biblioteca de Esquemas no Adobe Experience Platform, fornecendo uma interface de usuário e a API RESTful a partir da qual todos os recursos de biblioteca disponíveis podem ser acessados.

A API do Registro de esquema fornece vários endpoints que permitem gerenciar programaticamente todos os esquemas e os recursos relacionados do Experience Data Model (XDM) disponíveis na Platform. Isso inclui aqueles definidos pelo Adobe, parceiros Experience Platform e fornecedores cujos aplicativos você usa.

Esses endpoints são descritos abaixo. Visite os manuais de endpoint individuais para obter detalhes e consulte o guia de introdução para obter informações importantes sobre cabeçalhos necessários, como ler chamadas de API de exemplo e muito mais.

IMPORTANT
O XDM usa a formatação do esquema JSON para descrever e validar a estrutura dos dados de experiência do cliente assimilados. Antes de trabalhar com a API do Registro de Esquema, é altamente recomendável que você revise a documentação oficial do Esquema JSON para obter uma melhor compreensão dessa tecnologia subjacente.

Para exibir todos os pontos de extremidade e operações CRUD disponíveis, visite a Referência da API do Registro de Esquema.

Esquemas

Os esquemas XDM representam e validam a estrutura e o formato dos dados assimilados na Platform. Um esquema é composto por uma classe e zero ou mais grupos de campos de esquema. Você pode criar, exibir, editar e excluir esquemas usando o ponto de extremidade /schemas. Para saber como usar este ponto de extremidade, consulte o manual de ponto de extremidade de esquemas.

Para obter um guia passo a passo sobre como criar manualmente um esquema completo na API do Registro de Esquemas, incluindo a criação e adição de grupos de campos e tipos de dados, consulte o tutorial de criação de esquema de API.

Se você estiver assimilando dados CSV, consulte a seção sobre CSV para conversão de esquema.

Comportamentos

Os comportamentos definem a natureza dos dados que um esquema descreve. Cada classe XDM deve fazer referência a um comportamento específico, que todos os esquemas que empregam essa classe herdarão. Consulte o manual de endpoint de comportamentos para saber como visualizar os comportamentos disponíveis na API.

Classes

Uma classe define a estrutura básica de propriedades comuns que todos os esquemas baseados nessa classe devem conter e determina quais grupos de campos são elegíveis para uso nesses esquemas. Todas as classes devem ser associadas a um comportamento existente. Consulte o manual de ponto de extremidade de classes para obter detalhes sobre como trabalhar com classes na API.

Grupos de campos

Os grupos de campos são componentes reutilizáveis que definem um ou mais campos que representam um conceito específico, como uma pessoa individual, um endereço de correspondência ou um ambiente de navegador da Web. Os grupos de campos devem ser incluídos como parte de um esquema que implementa uma classe compatível, dependendo do comportamento dos dados que representam (registro ou série de tempo). Consulte o manual de endpoint de grupos de campos para saber como trabalhar com grupos de campos na API.

Tipos de dados

Os tipos de dados são usados como campos do tipo referência em classes ou grupos de campos da mesma forma que os campos literais básicos, com a principal diferença sendo que os tipos de dados podem definir vários subcampos. Embora semelhantes a grupos de campos, pois permitem o uso consistente de uma estrutura de vários campos, os tipos de dados são mais flexíveis porque podem ser incluídos em qualquer lugar na estrutura do esquema, enquanto os grupos de campos só podem ser adicionados no nível raiz. Consulte o manual de ponto de extremidade de tipos de dados para obter mais informações sobre como trabalhar com tipos de dados na API.

NOTE
Se um campo for definido como um tipo de dados específico, você não poderá criar o mesmo campo com um tipo de dados diferente em outro esquema. Essa restrição se aplica ao locatário da organização.

Descritores

Descritores são conjuntos de metadados atribuídos a campos específicos em um esquema, fornecendo vários detalhes contextuais, incluindo como esses campos (e o próprio esquema) estão relacionados a outros esquemas. Cada esquema pode ter uma ou mais entidades de descritor aplicadas a ele e há vários tipos diferentes de descritor para fins diferentes. Consulte o manual de endpoint de descritores para obter mais informações sobre como trabalhar com descritores na API e uma visão geral dos diferentes tipos de descritores e seus casos de uso.

Uniões

Embora a Platform permita compor esquemas para casos de uso específicos, ela também permite compor uma "união" de esquemas pertencentes a uma classe específica. Um esquema de união agrega os campos de todos os esquemas que compartilham a mesma classe em uma única representação. Ao habilitar um esquema para uso com o Perfil de Cliente em Tempo Real, esse esquema é incluído na união para sua classe específica. Dessa forma, os esquemas de união não podem ser editados diretamente e só podem ser afetados pela inclusão ou exclusão de esquemas para uso no Perfil.

Para saber como exibir uniões na API do Registro de Esquema, consulte o manual de ponto de extremidade de uniões.

CSV para conversão de esquema csv-to-schema

Você pode gerar automaticamente um esquema XDM usando um arquivo CSV como modelo, permitindo criar modelos para importar campos de esquema em massa e reduzir o trabalho manual da API ou da interface do usuário.

Consulte o guia do ponto de extremidade de conversão de CSV para esquema para obter mais informações.

NOTE
Você também pode usar a interface do usuário para mapear um CSV para um esquema usando recomendações geradas por IA (atualmente na versão beta).

Exportar export

A API do registro de esquema permite transferir e compartilhar recursos XDM entre sandboxes e organizações. Para qualquer esquema, grupo de campos ou tipo de dados, você pode gerar uma carga de exportação contendo a estrutura do recurso e quaisquer recursos dependentes. Essa carga pode ser usada para importar o recurso para uma sandbox e uma organização de destino.

Consulte o manual de endpoint de exportação para obter mais informações sobre como criar uma carga de exportação para um recurso XDM existente.

Importar

Se você usar os pontos de extremidade exportar ou CSV para conversão de esquema para criar uma carga de exportação, poderá enviar essa carga para uma organização de destino e uma sandbox para importar os recursos especificados.

Consulte o manual de endpoint de importação para obter mais informações sobre como gerar recursos XDM a partir de cargas de exportação.

Dados de amostra

Você pode gerar dados de amostra para qualquer esquema especificado na Biblioteca de esquemas. O objeto de resposta retornado pode ser usado como uma fonte de assimilação de dados.

Consulte o manual de ponto de extremidade de dados de exemplo para obter mais informações sobre o uso desse ponto de extremidade.

Log de auditoria

O Registro de esquema mantém um log de todas as alterações que ocorreram em um recurso (classe, grupo de campos, tipo de dados ou esquema) entre diferentes atualizações. Você pode recuperar o log de um recurso específico fornecendo seu $id ou meta:altId no caminho de uma solicitação GET para esse ponto de extremidade.

Consulte o manual de ponto de extremidade de log de auditoria para obter mais informações sobre o uso desse ponto de extremidade.

Próximas etapas

Para começar a fazer chamadas usando a API do registro de esquema, leia o guia de introdução e selecione um dos manuais de endpoint para saber como usar endpoints específicos.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07