Müşteriler için .NET hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzundaki adımları uygulayarak yaklaşık 10 dakikada, hizmet hesabı kullanarak sıfır dokunuşla kayıt müşteri API'sine istek gönderen basit bir .NET C# konsol uygulaması oluşturabilirsiniz.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için şunlara ihtiyacınız vardır:

  • El değmeden kayıt müşterinize bağlı bir hizmet hesabı hesap. Başlayın başlıklı makaleyi inceleyin.
  • Visual Studio 2013 veya sonraki sürümler.
  • İnternete ve web tarayıcısına erişim.

1. adım: El değmeden kayıt API'sini etkinleştirin

  1. Bunu kullanın sihirbazı kullanarak Google Developers Console'da proje oluşturabilir veya seçebilirsiniz ve API'yi otomatik olarak açabilir. Devam ve ardından Kimlik bilgilerine git'i tıklayın ziyaret edin.
  2. Hangi verilere erişeceksiniz? seçeneğini Uygulama verileri olarak ayarlayın.
  3. İleri'yi tıklayın. Hizmet oluşturmanız istenecektir hesap.
  4. Hizmet hesabı adı için açıklayıcı bir ad verin.
  5. Hizmet hesabı kimliğini (e-posta adresine benzer) not edin. Örneğin: sonradan kullanabilirsiniz.
  6. Roll'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı olarak ayarlayın.
  7. Hizmet hesabını oluşturma işlemini tamamlamak için Bitti'yi tıklayın.
  8. Oluşturduğunuz hizmet hesabının e-posta adresini tıklayın.
  9. **Anahtarlar**'ı tıklayın.
  10. **Anahtar ekle**'yi ve ardından **Yeni anahtar oluştur**'u tıklayın.
  11. **Anahtar türü** için **JSON**'u seçin.
  12. Oluştur'u tıkladığınızda özel anahtar bilgisayarınıza indirilir.
  13. **Kapat**'ı tıklayın.
  14. Dosyayı çalışma dizininize taşıyın ve service_account_key.json olarak yeniden adlandırın.

2. Adım: Projeyi hazırlayın

  1. Visual Studio'da yeni bir .NET Core C# Console Uygulaması projesi oluşturun.
  2. Paket Yöneticisi'ni açın, paket kaynağı olarak nuget.org'u seçin ve aşağıdaki paketleri ekleyin:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Daha fazla bilgi edinmek için şu Microsoft dokümanını okuyun: paketindedir.

3. Adım: Örneği ayarlayın

  1. Hizmet hesabınızı oluştururken indirdiğiniz service_account_key.json dosyasını Visual Studio Solution Explorer'a sürükleyin.
  2. service_account_key.json seçeneğini belirleyin, ardından Özellikler penceresine gidin ve Çıkış dizinine kopyala alanını Her zaman kopyala olarak ayarlayın.
  3. Program.cs içeriğini aşağıdaki kodla değiştirin:
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);
            }

        }
    }
}

4. Adım: Sana Özel'i çalıştırın

Örneği derleyip çalıştırmak için Visual Studio araç çubuğunda Başlat'ı tıklayın.

Notlar

  • service_account_key.json dosyanızı kimseyle paylaşmayın. Bu bilgileri kaynak kod depolarına dahil etmemeye dikkat edin. Web sitemiz g.co/newsinitiative/labs üzerinden hizmet hesabı gizli anahtarlarını işleme başlıklı makaleye bakın.

Daha fazla bilgi