Panduan memulai .NET untuk reseller

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

Prasyarat

Untuk menjalankan quickstart ini, Anda memerlukan:

  • Akun Google, yang adalah anggota reseller pendaftaran zero-touch Anda menggunakan akun layanan. Jika belum melakukan aktivasi, ikuti langkah-langkah dalam artikel 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 ini wizard untuk membuat atau memilih project di Google Developers Console dan mengaktifkan API secara otomatis. Klik Lanjutkan, lalu Buka kredensial.
  2. Setel Data apa yang akan Anda akses? ke Data aplikasi.
  3. Klik Berikutnya. Anda akan diminta untuk membuat akun layanan.
  4. Beri nama deskriptif untuk Nama akun layanan.
  5. Catat ID akun layanan (terlihat 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 **Kunci**.
  10. Klik **Add key**, kemudian klik **Create new key**.
  11. Untuk **Jenis kunci**, pilih **JSON**.
  12. Klik Buat dan kunci pribadi akan didownload ke komputer Anda.
  13. Klik **Close**.
  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 Layanan akun.
  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 zero-touch akun pendaftaran.

Langkah 3: Siapkan project

  1. Buat project Aplikasi Konsol C# .NET Core 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: Menyiapkan 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 Layanan akun.
  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 guna mengizinkan panggilan API, baca Otorisasi.

Pelajari lebih lanjut