.NET – krótkie wprowadzenie dla sprzedawców

Wykonaj czynności opisane w tym krótkim przewodniku, a w ciągu około 10 minut prosta aplikacja konsoli .NET C#, która wysyła żądania do rejestracji typu zero-touch. API sprzedawcy.

Wymagania wstępne

Aby skorzystać z tego krótkiego wprowadzenia, 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.

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 Dalej, a następnie Przejdź do danych logowania .
  2. Ustaw 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. Nadaj opisową nazwę 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 pakietu nuget.org i dodaj tych pakietów:
    • 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 (pobrany w kroku 1) do obrazu Eksplorator rozwiązań Studio.
  2. Wybierz service_account_key.json, przejdź do okna 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, kliknij Rozpocznij na pasku narzędzi Visual Studio.

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