रीसेलर के लिए .NET क्विकस्टार्ट

इस क्विकस्टार्ट गाइड में दिया गया तरीका अपनाएं. करीब 10 मिनट में, आपको एक आसान .NET C# कंसोल ऐप्लिकेशन मिल जाएगा. यह ज़ीरो-टच रजिस्ट्रेशन की सुविधा वाले रीसेलर एपीआई को अनुरोध भेजता है.

ज़रूरी शर्तें

यह क्विकस्टार्ट चलाने के लिए, आपको इन चीज़ों की ज़रूरत होगी:

  • ऐसा Google खाता जो आपके ज़ीरो-टच नामांकन के लिए बनाए गए रीसेलर खाते का सदस्य हो. अगर आपने अब तक इस सुविधा के लिए ऑप्ट-इन नहीं किया है, तो रीसेलर पोर्टल की गाइड में शुरू करें सेक्शन में दिया गया तरीका अपनाएं.
  • Visual Studio 2013 या उसके बाद का वर्शन.
  • इंटरनेट और वेब ब्राउज़र का ऐक्सेस.

पहला चरण: बिना किसी मानवीय सहायता के डिवाइस रजिस्टर करने की सुविधा देने वाला एपीआई चालू करना

  1. Google Developers Console में कोई प्रोजेक्ट बनाने या चुनने के लिए, इस विज़र्ड का इस्तेमाल करें. इससे एपीआई अपने-आप चालू हो जाएगा. जारी रखें पर क्लिक करें. इसके बाद, क्रेडेंशियल पर जाएं पर क्लिक करें.
  2. आपको कौनसा डेटा ऐक्सेस करना है? को ऐप्लिकेशन डेटा पर सेट करें.
  3. आगे बढ़ें पर क्लिक करें. आपको सेवा खाता बनाने के लिए कहा जाएगा.
  4. सेवा खाते का नाम के लिए, जानकारी देने वाला नाम दें.
  5. सेवा खाते का आईडी (यह ईमेल पते की तरह दिखता है) नोट करें, क्योंकि इसका इस्तेमाल बाद में किया जाएगा.
  6. भूमिका को सेवा खाते > सेवा खाते के उपयोगकर्ता पर सेट करें.
  7. सेवा खाता बनाने की प्रोसेस पूरी करने के लिए, हो गया पर क्लिक करें.
  8. आपने जो सेवा खाता बनाया है उसके ईमेल पते पर क्लिक करें.
  9. **कुंजी** पर क्लिक करें.
  10. **कुंजी जोड़ें** पर क्लिक करें. इसके बाद, **नई कुंजी बनाएं** पर क्लिक करें.
  11. **की टाइप** के लिए, **JSON** चुनें.
  12. बनाएं पर क्लिक करें और अपने कंप्यूटर पर निजी कुंजी डाउनलोड करें.
  13. **बंद करें** पर क्लिक करें.
  14. फ़ाइल को अपनी वर्किंग डायरेक्ट्री में ले जाएं और उसका नाम बदलकर service_account_key.json कर दें.
  1. ज़ीरो-टच रजिस्ट्रेशन पोर्टल खोलें. शायद आपको साइन इन करना पड़े.
  2. सेवा खाते पर क्लिक करें.
  3. सेवा खाता लिंक करें पर क्लिक करें.
  4. ईमेल पता को, आपके बनाए गए सेवा खाते के पते पर सेट करें.
  5. सेवा खाते को अपने ज़ीरो-टच रजिस्टर करने वाले खाते के साथ इस्तेमाल करने के लिए, सेवा खाता लिंक करें पर क्लिक करें.

तीसरा चरण: प्रोजेक्ट तैयार करना

  1. Visual Studio में नया .NET Core C# Console ऐप्लिकेशन प्रोजेक्ट बनाएं.
  2. Package Manager खोलें, पैकेज का सोर्स nuget.org चुनें, और ये पैकेज जोड़ें:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

ज़्यादा जानने के लिए, Microsoft दस्तावेज़ किसी पैकेज को इंस्टॉल और उसका इस्तेमाल करना पढ़ें.

चौथा चरण: सैंपल सेट अप करना

  1. service_account_key.json (पहले चरण में डाउनलोड किया गया) को अपने Visual Studio Solution Explorer में खींचें और छोड़ें.
  2. service_account_key.json को चुनें. इसके बाद, प्रॉपर्टी विंडो पर जाएं और आउटपुट डायरेक्ट्री में कॉपी करें फ़ील्ड को हमेशा कॉपी करें पर सेट करें.
  3. Program.cs के कॉन्टेंट की जगह यह कोड डालें.
  4. PartnerId (ऐप्लिकेशन की पहली लाइन) की वैल्यू के तौर पर, अपना रीसेलर पार्टनर आईडी डालें.
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");
            }
        }
    }
}

पार्टनर आईडी

आम तौर पर, एपीआई कॉल के लिए, आर्ग्युमेंट के तौर पर आपके रीसेलर पार्टनर आईडी की ज़रूरत होती है. 'पहले से तैयार डिवाइस' सुविधा वाले पोर्टल पर अपना पार्टनर आईडी ढूंढने के लिए, यहां दिया गया तरीका अपनाएं:

  1. पोर्टल खोलें. शायद आपको साइन इन करना पड़े.
  2. सेवा के लिए इस्तेमाल किए जाने वाले खाते पर क्लिक करें.
  3. आपका रीसेलर आईडी लाइन से अपना पार्टनर आईडी नंबर कॉपी करें.

पांचवां चरण: सैंपल चलाना

सैंपल बनाने और चलाने के लिए, Visual Studio टूलबार में शुरू करें पर क्लिक करें.

समस्या का हल

क्विकस्टार्ट में हमें बताएं कि क्या समस्या हुई. हम इसे ठीक करने के लिए काम करेंगे. यह जानने के लिए कि ज़ीरो-टच, एपीआई कॉल को अनुमति देने के लिए सेवा खातों का इस्तेमाल कैसे करता है, अनुमति लेख पढ़ें.

ज़्यादा जानें