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

Siga as etapas deste 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 para o registro sem toque API do cliente.

Pré-requisitos

Para executar este guia de início rápido, você precisa do seguinte:

  • Uma Conta do Google, que faça parte do seu cliente de registro sem toque do Compute Engine. Consulte a seção Informações contas de serviço.
  • Visual Studio 2013 ou mais recente.
  • Acesso à Internet e a um navegador da Web.

Etapa 1: ativar a API de 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 Acessar credenciais
  2. Clique em Cancelar em "Criar credenciais".
  3. Na parte superior da página, selecione a guia OAuth consent screen. Selecione um Endereço de e-mail, digite o Nome do produto, caso ainda não tenha sido definido. Clique no botão Salvar.
  4. Selecione a guia Credenciais e clique no botão Criar credenciais. e selecione ID do cliente OAuth.
  5. Selecione o tipo de aplicativo Outro e insira o nome. "Guia de início rápido" e clique no botão Criar .
  6. Clique em OK para dispensar o painel 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 de aplicativo do console do .NET Core C# no Visual Studio.
  2. Abra o Gerenciador de pacotes, selecione a origem do pacote nuget.org e adicione estes pacotes:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Para saber mais, leia o documento da Microsoft Instalar e usar um .

Etapa 3: configurar a amostra

  1. Arraste o arquivo client_secret.json (cujo download você fez na Etapa 1) para o Visual Studio. o Solution Explorer.
  2. Selecione client_secret.json, acesse a janela Propriedades e defina O campo Copiar para o diretório de saída para Sempre copiar.
  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 o exemplo, clique em Start 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 console do Cloud e abri-lo no navegador. Se você ainda não tiver feito login na sua Conta do Google, para 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 Aceitar.
  3. Feche a guia do navegador. O aplicativo continuará em execução.

Observações

  • Como a biblioteca cliente da API do Google armazena dados de autorização no sistema de arquivos, as Os lançamentos não solicitam autorização.
  • Para redefinir os dados de autorização do app, exclua o ~/.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 aprender a adicionar autorização para um aplicativo da web, consulte Usar OAuth 2.0, aplicativos da Web (ASP.NET MVC).

Solução de problemas

Aqui estão alguns itens comuns que você precisará verificar. Conte o que deu errado com o guia de início rápido para que possamos corrigir o problema.

  • Verifique se você está autorizando chamadas de API com a mesma Conta do Google que é membro da sua conta de cliente com registro sem toque. Tente fazer login no portal do registro sem toque usando o mesma Conta do Google para testar seu acesso.
  • Confirme se a conta aceitou os Termos de Serviço mais recentes em no portal. Consulte Contas de clientes.

Saiba mais