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

  • Konto Google należące do sprzedawcy, które jest członkiem konta sprzedawcy do rejestracji typu zero-touch. Jeśli nie udało Ci się jeszcze rozpocząć procesu wprowadzania, wykonaj czynności opisane w sekcji Rozpoczęcie w przewodniku po portalu dla sprzedawców.
  • Visual Studio 2013 lub nowsza wersja.
  • Dostęp do internetu i przeglądarki.

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

  1. Użyj tego kreatora, aby utworzyć lub wybrać projekt w Konsoli programistów Google i 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. Pojawi się prośba o utworzenie konta usługi.
  4. Podaj opisową nazwę w polu Nazwa konta usługi.
  5. Zapisz identyfikator konta usługi (wygląda jak adres e-mail), ponieważ będziesz go później używać.
  6. Ustaw Role (Rola) na Konta usługi > Użytkownik konta usługi.
  7. Aby zakończyć tworzenie konta usługi, kliknij Gotowe.
  8. Kliknij adres e-mail utworzonego przez Ciebie konta usługi.
  9. Kliknij **Klucze**.
  10. Kliknij kolejno **Dodaj klucz** i **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 Konta usługi.
  3. Kliknij Połącz konto usługi.
  4. Ustaw Adres e-mail jako adres utworzonego przez siebie konta usługi.
  5. Aby używać konta usługi z kontem do rejestracji bez interwencji człowieka, kliknij Połącz konto usługi.

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

Więcej informacji znajdziesz w dokumentacji Microsoftu Instalowanie i używanie pakietu.

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ść pliku Program.cs tym kodem.
  4. Wpisz własny identyfikator partnera sprzedawcy jako wartość parametru 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ą podania identyfikatora partnera jako argumentu. Aby znaleźć identyfikator partnera w portalu rejestracji typu zero-touch:

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

Krok 5. Uruchom kod

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 szybkim przewodniku, a my postaramy się rozwiązać problem. Więcej informacji o tym, jak rejestracja typu zero-touch używa kont usługi do autoryzowania wywołań interfejsu API, znajdziesz w artykule Autoryzacja.

Więcej informacji