Panduan memulai .NET untuk pelanggan

Ikuti langkah-langkah dalam panduan memulai ini, dan dalam waktu sekitar 10 menit Anda sudah aplikasi konsol .NET C# sederhana yang membuat permintaan ke pendaftaran zero-touch API pelanggan menggunakan akun layanan.

Prasyarat

Untuk menjalankan quickstart ini, Anda memerlukan:

  • Akun layanan, yang ditautkan ke pelanggan pendaftaran zero-touch Anda menggunakan akun layanan. Lihat Memulai .
  • 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. 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 (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 **Keys**.
  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 **Tutup**.
  14. Pindahkan file ke direktori kerja Anda dan ganti namanya menjadi service_account_key.json.

Langkah 2: Siapkan project

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

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

Langkah 3: Siapkan contoh

  1. Tarik service_account_key.json yang Anda download saat membuat akun layanan ke Visual Studio Solution Explorer.
  2. Pilih service_account_key.json, lalu buka jendela {i>Properties<i} dan setel kolom Copy to output directory ke Always copy.
  3. Ganti konten Program.cs dengan kode berikut:
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;
using System.Threading;

namespace ZeroTouchCustomerQuickstart
{
    class Program
    {
        // A single scope is used for the zero-touch enrollment customer API.
        static readonly string[] Scopes =
            { "https://www.googleapis.com/auth/androidworkzerotouchemm" };
        static string ApplicationName = "Zero-touch Enrollment .NET Quickstart";

        static void Main(string[] args)
        {
            GoogleCredential credential;

            // Authenticate using the service account key
            credential = GoogleCredential.FromFile("service_account_key.json")
                .CreateScoped(Scopes);

            // Create a zero-touch enrollment API service endpoint.
            var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer
            {
                HttpClientInitializer = credential,
                ApplicationName = ApplicationName
            });

            // Get the customer's account. Because a customer might have more
            // than one, limit the results to the first account found.
            CustomersResource.ListRequest accountRequest = service.Customers.List();
            accountRequest.PageSize = 1;
            CustomerListCustomersResponse accountResponse = accountRequest.Execute();
            if (accountResponse.Customers.Count == 0)
            {
                // No accounts found for the user. Confirm the Google Account
                // that authorizes the request can access the zero-touch portal.
                Console.WriteLine("No zero-touch enrollment account found.");
                Environment.Exit(-1);
            }
            Company customer = accountResponse.Customers[0];
            var customerAccount = String.Format("customers/{0}", customer.CompanyId);


            // Send an API request to list all the DPCs available.
            CustomersResource.DpcsResource.ListRequest request = service.Customers.Dpcs.
                List(customerAccount);
            CustomerListDpcsResponse response = request.Execute();

            // Print out the details of each DPC.
            IList<Dpc> dpcs = response.Dpcs;
            foreach (Dpc dpcApp in dpcs)
            {
                Console.WriteLine("Name:{0}  APK:{1}",
                                  dpcApp.DpcName,
                                  dpcApp.PackageName);
            }

        }
    }
}

Langkah 4: Jalankan contoh

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

Catatan

  • Hindari membagikan file service_account_key.json Anda kepada siapa pun. Berhati-hatilah agar tidak menyertakannya dalam repositori kode sumber. Anda dapat membaca saran lebih lanjut tentang menangani rahasia akun layanan.

Pelajari lebih lanjut