Siga as etapas neste guia de início rápido e, em cerca de 10 minutos, você terá um aplicativo simples de console .NET C# que faz solicitações à API do cliente de registro sem toque.
Pré-requisitos
Para executar este guia de início rápido, você precisa de:
- Uma Conta do Google que faz parte da sua conta de cliente do registro sem toque. Consulte Contas de cliente.
- Visual Studio 2013 ou posterior.
- Acesso à Internet e a um navegador da Web.
Etapa 1: ativar a API do registro sem toque
- Use este assistente para criar ou selecionar um projeto no Google Developers Console e ativar a API automaticamente. Clique em Continuar e, em seguida, em Acessar credenciais.
- Clique em Cancelar na opção "Criar credenciais".
- Na parte superior da página, selecione a guia OAuth consent screen. Selecione um Endereço de e-mail, insira um Nome de produto, se ainda não tiver definido, e clique no botão Salvar.
- Selecione a guia Credenciais, clique no botão Criar credenciais e selecione ID do cliente OAuth.
- Selecione o tipo de aplicativo Outro, insira o nome "Início rápido" e clique no botão Criar.
- Clique em OK para dispensar o painel do cliente OAuth.
- Clique em Fazer o download do JSON.
- Mova o arquivo para o diretório de trabalho e renomeie-o como
client_secret.json
.
Etapa 2: preparar o projeto
- Crie um novo projeto .NET Core C# Console Application no Visual Studio.
- Abra o Gerenciador de pacotes, selecione a origem do pacote nuget.org e adicione os seguintes pacotes:
Google.Apis.AndroidProvisioningPartner.v1
Google.Apis.Auth
Para saber mais, leia o documento da Microsoft Instalar e usar um pacote.
Etapa 3: configurar a amostra
- Arraste
client_secret.json
(cujo download você fez na Etapa 1) para seu Visual Studio Solution Explorer. - Selecione
client_secret.json
, acesse a janela "Properties" e defina o campo Copy to output directory como Always copy. - Substitua o conteúdo de
Program.cs
pelo seguinte código:
using Google.Apis.AndroidProvisioningPartner.v1; using Google.Apis.AndroidProvisioningPartner.v1.Data; using Google.Apis.Auth.OAuth2; using Google.Apis.Services; using Google.Apis.Util.Store; using System; using System.Collections.Generic; using System.IO; using System.Threading; namespace ZeroTouchCustomerQuickstart { class Program { // A single scope is used for the zero-touch enrollment customer API. static readonly string[] Scopes = { "https://www.googleapis.com/auth/androidworkzerotouchemm" }; static string ApplicationName = "Zero-touch Enrollment .NET Quickstart"; static void Main(string[] args) { UserCredential credential; // Ask the user to authorize the request using their Google Account // in their browser. using (var stream = new FileStream("client_secret.json", FileMode.Open, FileAccess.Read)) { string credPath = System.Environment.GetFolderPath( System.Environment.SpecialFolder.Personal); credPath = Path.Combine(credPath, ".credentials/zero-touch.quickstart.json"); credential = GoogleWebAuthorizationBroker.AuthorizeAsync( GoogleClientSecrets.FromStream(stream).Secrets, Scopes, "user", CancellationToken.None, new FileDataStore(credPath, true)).Result; Console.WriteLine("Credential file saved to: " + credPath); } // Create a zero-touch enrollment API service endpoint. var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer { HttpClientInitializer = credential, ApplicationName = ApplicationName }); // Get the customer's account. Because a customer might have more // than one, limit the results to the first account found. CustomersResource.ListRequest accountRequest = service.Customers.List(); accountRequest.PageSize = 1; CustomerListCustomersResponse accountResponse = accountRequest.Execute(); if (accountResponse.Customers.Count == 0) { // No accounts found for the user. Confirm the Google Account // that authorizes the request can access the zero-touch portal. Console.WriteLine("No zero-touch enrollment account found."); Environment.Exit(-1); } Company customer = accountResponse.Customers[0]; var customerAccount = String.Format("customers/{0}", customer.CompanyId); // Send an API request to list all the DPCs available. CustomersResource.DpcsResource.ListRequest request = service.Customers.Dpcs. List(customerAccount); CustomerListDpcsResponse response = request.Execute(); // Print out the details of each DPC. IList<Dpc> dpcs = response.Dpcs; foreach (Dpc dpcApp in dpcs) { Console.WriteLine("Name:{0} APK:{1}", dpcApp.DpcName, dpcApp.PackageName); } } } }
Etapa 4: executar a amostra
Para criar e executar a amostra, clique em
Iniciar na barra de ferramentas do Visual Studio.Na primeira vez que você executar o app, será necessário autorizar o acesso:
- O app tenta abrir uma nova guia no navegador padrão. Se isso falhar, copie o URL do console e abra-o no navegador. Se você ainda não estiver conectado à sua Conta do Google, será solicitado a fazer login. Se você estiver conectado a várias Contas do Google, a página solicitará que você selecione uma conta para a autorização.
- Clique em Accept.
- Feche a guia do navegador. O aplicativo continuará em execução.
Observações
- Como a biblioteca de cliente da API do Google armazena dados de autorização no sistema de arquivos, os lançamentos subsequentes não solicitam autorização.
- Para redefinir os dados de autorização do app, exclua o arquivo
~/.credentials/zero-touch.quickstart.json
e execute o app novamente. - O fluxo de autorização neste guia de início rápido é ideal para um app de linha de comando. Para saber como adicionar autorização a um app da Web, consulte Como usar o OAuth 2.0, aplicativos da Web (ASP.NET MVC).
Solução de problemas
Veja algumas coisas comuns que convém verificar. Conte o que deu errado no guia de início rápido, e nós trabalharemos para corrigi-lo.
- Verifique se você está autorizando chamadas de API com a mesma Conta do Google que é membro da sua conta de cliente do registro sem toque. Tente fazer login no portal do registro sem toque usando a mesma Conta do Google para testar seu acesso.
- Confirme se a conta aceitou os Termos de Serviço mais recentes no portal. Consulte Contas do cliente.