Bayiler için .NET hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzundaki adımları uygulayın. Yaklaşık 10 dakika içinde El değmeden kayıt için istek gönderen basit bir .NET C# konsol uygulaması satıcı API'sı ekleyebilirsiniz.

Ö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 bayinizin üyesi olan bir Google Hesabı hesap. Henüz ilk katılımı gerçekleştirmediyseniz aşağıdaki Başlarken bölümünde verilen adımları uygulayın: Bayi portalı kılavuzuna bakın.
  • 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? alanını 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. Rol'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı.
  7. Hizmet hesabını oluşturmayı tamamlamak için Bitti'yi tıklayın.
  8. Oluşturduğunuz hizmet hesabının e-posta adresini tıklayın.
  9. **Tuşlar**'ı tıklayın.
  10. **Anahtar ekle**'yi, ardından **Yeni anahtar oluştur**'u tıklayın.
  11. **Anahtar türü** için **JSON**'yi 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.
  1. El değmeden kayıt portalını açın. Oturum açmanız gerekebilir.
  2. Hizmeti'ni tıklayın hesaplar.
  3. Hizmet hesabını bağla'yı tıklayın.
  4. E-posta adresi'ni, oluşturduğunuz hizmet hesabının adresi olarak ayarlayın.
  5. Hizmet hesabını el değmeden kayıt cihazınızla kullanmak için Hizmet hesabını bağla'yı tıklayın. kayıt hesabı.

3. 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ğını nuget.org seçin ve şu paketler:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

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

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

  1. service_account_key.json öğesini (1. adımda indirilen), Visual öğenize sürükleyin Studio Çözüm Gezgini.
  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.
  4. için değer olarak kendi bayi iş ortağı kimliğinizi girin PartnerId (uygulamanın ilk satırı).
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");
            }
        }
    }
}

İş Ortağı Kimliği

API çağrılarında genellikle bağımsız değişken olarak bayi iş ortağı kimliğiniz gerekir. Mevcut El değmeden kayıt portalındaki iş ortağı kimliğini öğrenmek için aşağıdaki adımları uygulayın:

  1. Portalı açın. Oturum açmanız gerekebilir.
  2. Hizmeti'ni tıklayın hesaplar.
  3. Bayi kimliğiniz satırından iş ortağı kimlik numaranızı kopyalayın.

5. Adım: Örneği çalıştırın

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

Sorun giderme

Hızlı başlangıç kılavuzuyla ilgili sorunu bize bildirin, gerekli işlemleri yapalım. bu sorunu çözmek için. El değmeden kayıt özelliğinin, API çağrılarını yetkilendirmek için hizmet hesaplarını nasıl kullandığını öğrenmek için şu makaleyi okuyun: Yetkilendirme.

Daha fazla bilgi