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

Siga as etapas neste guia de início rápido e, em cerca de 10 minutos, você terá um app de console .NET C# simples que faz solicitações à API de revendedor de inscrição sem contato.

Pré-requisitos

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

  • Uma Conta do Google, que seja membro do seu revendedor de registro sem toque do Compute Engine. Se você ainda não fez a integração, siga as etapas em Começar no guia do Portal do revendedor.
  • 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. Defina Quais dados você acessará? como Dados do aplicativo.
  3. Clique em Próxima. Você vai receber uma solicitação para criar uma conta de serviço.
  4. Dê um nome descritivo para o Nome da conta de serviço.
  5. Anote o ID da conta de serviço (parece um endereço de e-mail) porque você usá-lo mais tarde.
  6. Defina o Papel como Contas de serviço > Usuário da conta de serviço.
  7. Clique em Concluído para terminar a criação da conta de serviço.
  8. Clique no endereço de e-mail da conta de serviço que você criou.
  9. Clique em **Chaves**.
  10. Clique em **Adicionar chave** e em **Criar nova chave**.
  11. Em **Tipo de chave**, selecione **JSON**.
  12. Clique em Criar. O download da chave privada é feito no computador.
  13. Clique em **Fechar**.
  14. Mova o arquivo para o diretório de trabalho e renomeie-o como service_account_key.json.
  1. Abra o portal do registro sem toque. Talvez seja necessário fazer login.
  2. Clique em Serviço contas.
  3. Clique em Vincular conta de serviço.
  4. Defina Endereço de e-mail como o endereço da conta de serviço que você criou.
  5. Clique em Vincular conta de serviço para usá-la com o registro sem toque. conta de registro.

Etapa 3: preparar o projeto

  1. Crie um novo projeto de aplicativo de console C# do .NET Core 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 4: configurar a amostra

  1. Arraste service_account_key.json (salvo na Etapa 1) para o Visual o Solution Explorer do Studio.
  2. Selecione service_account_key.json, acesse a janela "Properties" e Defina o campo Copiar para o diretório de saída como Sempre copiar.
  3. Substitua o conteúdo de Program.cs pelo código a seguir.
  4. Insira seu próprio ID do parceiro revendedor como o valor de PartnerId (a primeira linha do app).
using Google.Apis.AndroidProvisioningPartner.v1;
using Google.Apis.AndroidProvisioningPartner.v1.Data;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
using System.IO;

namespace ZeroTouchResellerQuickstart
{
    class Program
    {
        // TODO: replace this with your partner reseller ID.
        static long PartnerId = 11036885;

        // Use a single scope for the all methods in the reseller API.
        static readonly string[] Scopes =
        { "https://www.googleapis.com/auth/androidworkprovisioning" };
        static string ApplicationName = "Zero-touch Reseller .NET Quickstart";

        static void Main(string[] args)
        {
            // Create a credential to authorize API requests using a service account key.
            // The service account must be linked using the zero-touch portal.
            ServiceAccountCredential credential;
            using (var stream =
                new FileStream("service_account_key.json", FileMode.Open, FileAccess.Read))
            {
                credential = GoogleCredential.FromStream(stream)
                                     .CreateScoped(Scopes)
                                     .UnderlyingCredential as ServiceAccountCredential;
            }

            // Create a zero-touch enrollment API service endpoint.
            var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer
            {
                HttpClientInitializer = credential,
                ApplicationName = ApplicationName
            });

            // Send an API request to list all our customers.
            PartnersResource.CustomersResource.ListRequest request =
                service.Partners.Customers.List(PartnerId);
            ListCustomersResponse response = request.Execute();

            // Print out the details of each customer.
            IList<Company> customers = response.Customers;
            if (customers != null)
            {
                foreach (Company customer in customers)
                {
                    Console.WriteLine("Name:{0}  ID:{1}",
                                      customer.CompanyName,
                                      customer.CompanyId);
                }
            }
            else
            {
                Console.WriteLine("No customers found");
            }
        }
    }
}

ID do parceiro

As chamadas de API geralmente precisam do ID do parceiro revendedor como argumento. Para encontrar seu ID do parceiro no portal de registro sem toque, siga as etapas abaixo:

  1. Abra o portal. Talvez seja necessário fazer login.
  2. Clique em Serviço contas.
  3. Copie o número do ID do parceiro na linha Seu ID de revendedor.

Etapa 5: executar a amostra

Para criar e executar o exemplo, clique em Start na barra de ferramentas do Visual Studio.

Solução de problemas

Informe o que deu errado com o guia de início rápido, e vamos trabalhar para corrigir o problema. Para saber como o registro sem toque usa contas de serviço para autorizar chamadas de API, leia Autorização.

Saiba mais