Esta página foi traduzida pela API Cloud Translation.

Vamos começar

Antes de usar a Biblioteca comum de revendedores do Android, os revendedores precisam participar do Programa de implantação do Knox e do registro sem toque do Android da Samsung.

Programa de implantação do Knox (KDP)

Siga as etapas abaixo para participar do KDP e recuperar os detalhes necessários para começar a usar a biblioteca do revendedor.

Etapa 1: fazer a inscrição no KDP

Acesse o Samsung Knox para revendedores para se inscrever no KDP.
Crie uma conta Samsung e inscreva-se em uma conta Samsung Knox como revendedor.
Depois que sua conta de revendedor for aprovada, faça login no portal do KDP para encontrar o resellerId.

Etapa 2: solicitar acesso ao Knox Cloud API Portal

Envie uma solicitação à Samsung para ter acesso ao Knox Cloud API Portal.
Faça login no Portal da API Knox Cloud.

Etapa 3: receber chaves da conta de serviço e o `clientIdentifier`

Faça o download do arquivo JSON do par de chaves no portal da API Knox Cloud e armazene-o em um local seguro.
Gere seu clientIdentifier exclusivo no portal da API Knox Cloud.

Etapa 4: criar o objeto `SamsungResellerService`

Use o caminho de arquivo JSON, clientIdentifier, resellerId para criar o objeto SamsungResellerService e usar a biblioteca comum.

Registro sem toque

Etapa 1: participar do programa de registro sem toque

Faça a integração com o registro sem toque.
Como a Biblioteca comum de revendedores do Android usa a API Reseller, você precisa pedir acesso à API de revendedor ao consultor de soluções da plataforma do Google.
Solicite acesso ao portal sem toque.

Com a mesma Conta do Google que você usa para acessar o portal, siga as instruções restantes para criar uma conta de serviço e ativar a API Reseller.

Etapa 2: criar uma conta de serviço

Uma conta de serviço, às vezes chamada de conta de robô, é uma Conta do Google que representa apps em vez de usuários. Como a biblioteca de registro chama as APIs do Google em nome da conta de serviço, use o Console de APIs do Google para configurar o acesso.

Criar um projeto do Console de APIs

É recomendável criar um novo projeto e conta de serviço do Console da API. Isso facilita o gerenciamento de acesso, gerenciamento de recursos e correção de chaves perdidas no futuro. Comece seguindo as etapas abaixo para criar um novo projeto no Console de APIs do Google:

Acesse o Console de APIs.
Na lista de projetos, selecione Criar um projeto.
Insira um nome que descreva o app e o registro sem toque.
Especifique um ID do projeto ou aceite o padrão.
Clique em Criar.

Para saber mais, leia o documento do Google Cloud Platform Gerenciar projetos no console.

Adicionar novas credenciais de serviço

Para adicionar novas credenciais e uma conta de serviço ao projeto, siga as etapas abaixo no Console de APIs.

Abra a página Contas de serviço. Se solicitado, selecione um projeto.
Clique em Criar conta de serviço, digite um nome e uma descrição para a conta correspondente. Você pode usar o ID da conta de serviço padrão ou escolher um código diferente e único. Quando terminar, clique em Criar.
A seção seguinte ,Permissões da conta de serviço (opcional), não é necessária. Clique em Continuar.
Em Conceda aos usuários acesso a essa conta de serviço, role a tela para baixo até a seção Criar chave. Clique em Criar chave.
No painel lateral que aparece, selecione o formato da sua chave: JSON é recomendado.
Clique em Criar. Seu novo par de chave pública/privada é gerado, e o download é feito na sua máquina. Essa é a única cópia da chave. Para saber mais sobre como armazenar com segurança, consulte Como gerenciar chaves de contas de serviço.
Clique em Fechar na caixa de diálogo Chave privada salva no seu computador e clique em Concluir para retornar à tabela das suas contas de serviço.

Copie o endereço de e-mail da conta de serviço e mantenha-o à mão. Você vai precisar dele mais tarde, ao vincular a conta de serviço à sua organização.

Etapa 3: armazenar o arquivo de chave JSON

O Console de APIs gera um novo par de chaves privadas usado para autenticar chamadas de API feitas usando sua conta de serviço. A chave privada está no arquivo de chave JSON que você transferiu por download.

Mantenha a chave privada. Portanto, não a inclua no código-fonte do software. Se você perder o arquivo da chave, vai precisar gerar um novo par de chaves.

Para saber mais sobre como armazenar o arquivo de chave com segurança, leia Práticas recomendadas para usar chaves de API com segurança.

Etapa 4: ativar a API

Ative a biblioteca do revendedor para usar a API Reseller. A ativação de uma API o associa ao projeto atual do Console de APIs e adiciona páginas de monitoramento ao console.

Para ativar a API Reseller, siga as etapas abaixo no Console de APIs:

Clique em APIs e serviços & gt; Biblioteca.
Use o campo de pesquisa para encontrar a API Android Device Provisioning Partner.
Clique em API Android Device Provisioning Partner.
Selecione Ativar.

Após um pequeno atraso, o status da API muda para ativado. Se você não vir a API Android Device Provisioning Partner, verifique se a organização está integrada ao registro sem toque. Verifique se você está usando a mesma Conta do Google para o registro sem toque e o Console de APIs do Google. Peça ao consultor de soluções da plataforma do Google para verificar se sua Conta do Google tem acesso à API.

Etapa 5: vincular a conta de serviço

Vincular a conta de serviço à conta de registro sem toque da sua organização autoriza a conta de serviço a fazer chamadas de API em nome da organização. Siga as etapas abaixo para vincular sua conta de serviço:

Abra o portal do registro sem toque. Talvez seja necessário fazer login.
Clique em Contas de serviço.
Clique em Vincular conta de serviço.
Defina o Endereço de e-mail como o endereço da conta de serviço que você criou.
Clique em Vincular conta de serviço para usar a conta de serviço com sua conta de registro sem toque.

Se você não encontrar o endereço de e-mail da conta de serviço que você criou, copie-o de um dos seguintes locais:

Um ID da conta de serviço da página Contas de serviço no Console de APIs do Google.
O campo da propriedade client_email no arquivo de chave JSON.

Agora é possível usar a conta de serviço com a biblioteca de inscrição para criar objetos ResellerService.

Adicionar a biblioteca comum de revendedor do Android a um projeto do Gradle

A biblioteca está disponível como um repositório Maven. Siga estas etapas para adicionar a biblioteca a um novo projeto do Gradle:

Execute este comando para criar um novo projeto:

gradle init --type basic
mkdir -p src/main/java src/main/resources

Copie o arquivo service_account_key.json que você salvou na Etapa 2 no diretório src/main/resources/ criado acima.
Abra o arquivo build.gradle padrão e declare o repositório Maven central para seu build:
```
repositories {
    mavenCentral()
}
```

No mesmo arquivo, adicione a seguinte dependência:

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

Seu projeto agora pode usar a biblioteca de cliente para registrar dispositivos Android.

Próximas etapas:Operações comuns