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 bayi API'sine istek gönderen basit bir .NET C# konsol uygulamasına sahip olacaksınız.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için şunlar gerekir:

  • El değmeden kayıt özellikli bayi hesabınızın üyesi olan bir Google Hesabı. Henüz ilk katılım işlemini tamamlamadıysanız Bayi portalı kılavuzundaki Başlayın bölümündeki adımları uygulayın.
  • Visual Studio 2013 veya sonraki sürümler.
  • İnternete ve web tarayıcıya erişim.

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

  1. Google Developers Console'da proje oluşturmak veya seçmek ve API'yi otomatik olarak etkinleştirmek için bu sihirbazı kullanın. Devam'ı, ardından Kimlik bilgilerine git'i tıklayın.
  2. Hangi verilere erişeceksiniz? seçeneğini Uygulama verileri olarak ayarlayın.
  3. İleri'yi tıklayın. Hizmet hesabı oluşturmanız istenecektir.
  4. Hizmet hesabı adı alanına açıklayıcı bir ad girin.
  5. Daha sonra kullanacağınız için Hizmet hesabı kimliğini (e-posta adresine benzer) not edin.
  6. Roll'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı olarak ayarlayın.
  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. **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**'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. Hizmet hesapları'nı tıklayın.
  3. Hizmet hesabını bağla'yı tıklayın.
  4. E-posta adresi'ni, oluşturduğunuz hizmet hesabının adresine ayarlayın.
  5. Hizmet hesabını sıfır dokunuşla kayıt hesabınızla kullanmak için Hizmet hesabını bağla'yı tıklayın.

3. adım: Projeyi hazırlayın

  1. Visual Studio'da yeni bir .NET Core C# Konsol 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 Microsoft'un Paket yükleme ve kullanma başlıklı belgesini inceleyin.

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

  1. service_account_key.json dosyasını (1. adımda indirilen) Visual Studio Solution Explorer'a sürükleyin.
  2. service_account_key.json simgesini seçin, ardından Özellikler penceresine gidin ve Çıkış dizine kopyala alanını Her zaman kopyala olarak ayarlayın.
  3. Program.cs içeriğini aşağıdaki kodla değiştirin.
  4. PartnerId (uygulamanın ilk satırı) için kendi bayi iş ortağı kimliğinizi girin.
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 bayi iş ortağı kimliğiniz bağımsız değişken olarak kullanılır. El değmeden kayıt portalında iş ortağı kimliğinizi bulmak için aşağıdaki adımları uygulayın:

  1. Portalı açın. Oturum açmanız gerekebilir.
  2. Hizmet hesapları'nı tıklayın.
  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 derleyip çalıştırmak için Visual Studio araç çubuğunda Başlat'ı tıklayın.

Sorun giderme

Hızlı başlangıçla ilgili nelerin yanlış gittiğini bize bildirin. Sorunu düzeltmek için gerekeni yapacağız. API çağrılarını yetkilendirmek için sıfır dokunuşlu hizmet hesaplarını nasıl kullandığını öğrenmek isterseniz Yetkilendirme başlıklı makaleyi inceleyin.

Daha fazla bilgi