Panduan memulai .NET untuk reseller

Ikuti langkah-langkah dalam panduan memulai ini, dan dalam waktu sekitar 10 menit, Anda akan memiliki aplikasi konsol .NET C# sederhana yang membuat permintaan ke API reseller pendaftaran zero-touch.

Prasyarat

Untuk menjalankan quickstart ini, Anda memerlukan:

  • Akun Google, yang adalah anggota akun reseller pendaftaran zero-touch Anda. Jika Anda belum melakukan aktivasi, ikuti langkah-langkah dalam Memulai di Panduan portal reseller.
  • Visual Studio 2013 atau yang lebih baru.
  • Akses ke internet dan browser web.

Langkah 1: Aktifkan API pendaftaran zero-touch

  1. Gunakan wizard ini untuk membuat atau memilih project di Konsol Google Developers dan mengaktifkan API secara otomatis. Klik Lanjutkan, lalu Buka kredensial.
  2. Tetapkan Data apa yang akan Anda akses? ke Data aplikasi.
  3. Klik Berikutnya. Anda akan diminta untuk membuat akun layanan.
  4. Berikan nama deskriptif untuk Nama akun layanan.
  5. Catat ID akun layanan (tampilannya seperti alamat email) karena Anda akan menggunakannya nanti.
  6. Tetapkan Role ke Service Accounts > Service Account User.
  7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.
  8. Klik alamat email untuk akun layanan yang Anda buat.
  9. Klik **Keys**.
  10. Klik **Add key**, kemudian klik **Create new key**.
  11. Untuk **Key type**, pilih **JSON**.
  12. Klik Buat dan kunci pribadi akan didownload ke komputer Anda.
  13. Klik **Tutup**.
  14. Pindahkan file ke direktori kerja Anda dan ganti namanya menjadi service_account_key.json.
  1. Buka portal pendaftaran zero-touch. Anda mungkin perlu login.
  2. Klik Akun layanan.
  3. Klik Tautkan akun layanan.
  4. Tetapkan Alamat email ke alamat akun layanan yang Anda buat.
  5. Klik Tautkan akun layanan untuk menggunakan akun layanan dengan akun pendaftaran zero-touch Anda.

Langkah 3: Siapkan project

  1. Buat project Konsol Aplikasi .NET Core C# baru di Visual Studio.
  2. Buka Pengelola Paket, pilih sumber paket nuget.org, lalu tambahkan paket berikut:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Untuk mempelajari lebih lanjut, baca dokumen Microsoft Menginstal dan menggunakan paket.

Langkah 4: Siapkan contoh aplikasi

  1. Tarik service_account_key.json (didownload di Langkah 1) ke Visual Studio Solution Explorer.
  2. Pilih service_account_key.json, lalu buka jendela Properties dan tetapkan kolom Copy to output directory ke Always copy.
  3. Ganti konten Program.cs dengan kode berikut.
  4. Masukkan ID partner reseller Anda sendiri sebagai nilai untuk PartnerId (baris pertama aplikasi).
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 Partner

Panggilan API biasanya memerlukan ID partner reseller Anda sebagai argumen. Untuk menemukan ID partner dari portal pendaftaran zero-touch, ikuti langkah-langkah di bawah:

  1. Buka portal. Anda mungkin perlu login.
  2. Klik Akun layanan.
  3. Salin nomor ID partner Anda dari baris ID reseller Anda.

Langkah 5: Jalankan contoh

Untuk membuat dan menjalankan contoh, klik Start di toolbar Visual Studio.

Pemecahan masalah

Beri tahu kami masalahnya dengan panduan memulai dan kami akan berupaya memperbaikinya. Untuk mempelajari cara zero-touch menggunakan akun layanan untuk memberikan otorisasi pada panggilan API, baca Otorisasi.

Pelajari lebih lanjut