.NET – krótkie wprowadzenie dla sprzedawców

Postępuj zgodnie z instrukcjami w tym przewodniku, a za około 10 minut będziesz mieć prostą aplikację konsoli .NET C#, która wysyła żądania do interfejsu API resellera do rejestracji bezdotykowej.

Wymagania wstępne

Aby uruchomić to krótkie wprowadzenie, musisz mieć:

  • konto Google należące do sprzedawcy obsługującego rejestrację typu zero-touch. koncie. Jeśli nie korzystasz jeszcze z tej usługi, wykonaj czynności opisane w sekcji Pierwsze kroki w przewodnika po portalu sprzedawcy.
  • Visual Studio w wersji 2013 lub nowszej.
  • dostęp do internetu i przeglądarki internetowej;

Krok 1. Włącz interfejs API rejestracji typu zero-touch

  1. Użyj tego w kreatorze, aby utworzyć lub wybrać projekt w Google Developers Console oraz automatycznie włączyć interfejs API. Kliknij kolejno Dalej i Przejdź do danych logowania.
  2. Ustaw opcję Do jakich danych będziesz uzyskiwać dostęp? na Dane aplikacji.
  3. Kliknij Dalej. Powinien wyświetlić się monit o utworzenie usługi. koncie.
  4. Podaj opisową nazwę w polu Nazwa konta usługi.
  5. Zapisz identyfikator konta usługi (wygląda jak adres e-mail), bo użyjemy jej później.
  6. Ustaw Rola na Konta usługi > Użytkownik kont usługi.
  7. Aby zakończyć tworzenie konta usługi, kliknij Gotowe.
  8. Kliknij adres e-mail utworzonego konta usługi.
  9. Kliknij **Klucze**.
  10. Kliknij **Dodaj klucz**, a następnie **Utwórz nowy klucz**.
  11. W polu **Typ klucza** wybierz **JSON**.
  12. Kliknij Utwórz, a klucz prywatny zostanie pobrany na komputer.
  13. Kliknij **Zamknij**.
  14. Przenieś plik do katalogu roboczego i zmień jego nazwę na service_account_key.json.
.
  1. Otwórz portal rejestracji typu zero-touch. W razie potrzeby zaloguj się.
  2. Kliknij Usługa kont.
  3. Kliknij Połącz konto usługi.
  4. Ustaw Adres e-mail na adres utworzonego przez siebie konta usługi.
  5. Kliknij Połącz konto usługi, aby używać konta usługi w przypadku rejestracji typu zero-touch. konta rejestracji.

Krok 3. Przygotuj projekt

  1. Utwórz w Visual Studio nowy projekt aplikacji konsoli .NET Core C#.
  2. Otwórz Menedżera pakietów, wybierz źródło pakietów nuget.org i dodaj te pakiety:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Aby dowiedzieć się więcej, przeczytaj dokument firmy Microsoft Instalowanie i używanie .

Krok 4. Skonfiguruj próbkę

  1. Przeciągnij plik service_account_key.json (pobierany w kroku 1) do Eksploratora rozwiązań w Visual Studio.
  2. Kliknij service_account_key.json, a następnie otwórz okno Właściwości i ustaw pole Kopiuj do katalogu wyjściowego na Zawsze kopiuj.
  3. Zastąp zawartość pola Program.cs poniższym kodem.
  4. Wpisz własny identyfikator partnera sprzedawcy jako wartość pola. PartnerId (pierwszy wiersz aplikacji).
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");
            }
        }
    }
}

Identyfikator partnera

Wywołania interfejsu API zwykle wymagają identyfikatora partnera sprzedawcy jako argumentu. Aby znaleźć identyfikatora partnera z portalu rejestracji typu zero-touch wykonaj te czynności:

  1. Otwórz portal. W razie potrzeby zaloguj się.
  2. Kliknij Usługa kont.
  3. Skopiuj identyfikator partnera z wiersza Twój identyfikator sprzedawcy.

Krok 5. Uruchamianie przykładu

Aby skompilować i uruchomić przykład, na pasku narzędzi Visual Studio kliknij Start (Uruchom).

Rozwiązywanie problemów

Powiedz nam, co poszło nie tak w ramach tego krótkiego wprowadzenia, a my postaramy się napraw to. Aby dowiedzieć się, jak rejestracja typu zero-touch używa kont usługi do autoryzowania wywołań interfejsu API, przeczytaj artykuł Autoryzacja.

Więcej informacji