Guia de início rápido do .NET para clientes

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

  1. 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.
  2. Clique em Cancelar na opção "Criar credenciais".
  3. 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.
  4. Selecione a guia Credenciais, clique no botão Criar credenciais e selecione ID do cliente OAuth.
  5. Selecione o tipo de aplicativo Outro, insira o nome "Início rápido" e clique no botão Criar.
  6. Clique em OK para dispensar o painel do cliente OAuth.
  7. Clique em Fazer o download do JSON.
  8. Mova o arquivo para o diretório de trabalho e renomeie-o como client_secret.json.

Etapa 2: preparar o projeto

  1. Crie um novo projeto .NET Core C# Console Application no Visual Studio.
  2. 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

  1. Arraste client_secret.json (cujo download você fez na Etapa 1) para seu Visual Studio Solution Explorer.
  2. Selecione client_secret.json, acesse a janela "Properties" e defina o campo Copy to output directory como Always copy.
  3. 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:

  1. 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.
  2. Clique em Accept.
  3. 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.

Saiba mais