شروع سریع دات نت برای فروشندگان

مراحل این راهنمای شروع سریع را دنبال کنید، تا حدوداً 10 دقیقه دیگر یک برنامه کنسول C#.NET ساده خواهید داشت که درخواست‌هایی را به API توزیع‌کننده ثبت‌نام صفر لمسی ارسال می‌کند.

پیش نیازها

برای اجرای این شروع سریع، به موارد زیر نیاز دارید:

  • یک حساب Google، که عضوی از حساب فروشنده ثبت نام بدون لمس شما است. اگر هنوز وارد نشده‌اید، مراحل «شروع به کار» در راهنمای پورتال Reseller را دنبال کنید.
  • ویژوال استودیو 2013 یا جدیدتر.
  • دسترسی به اینترنت و مرورگر وب.

مرحله 1: API ثبت نام بدون لمس را روشن کنید

  1. از این جادوگر برای ایجاد یا انتخاب یک پروژه در Google Developers Console استفاده کنید و به طور خودکار API را روشن کنید. روی Continue کلیک کنید، سپس به اعتبارنامه بروید .
  2. تنظیم کنید به چه داده هایی دسترسی خواهید داشت؟ به داده های برنامه
  3. روی Next کلیک کنید. باید از شما خواسته شود که یک حساب خدمات ایجاد کنید.
  4. یک نام توصیفی برای نام حساب سرویس بدهید.
  5. به شناسه حساب سرویس توجه کنید (به نظر می رسد یک آدرس ایمیل است) زیرا بعداً از آن استفاده خواهید کرد.
  6. نقش را روی حساب‌های سرویس > کاربر حساب سرویس تنظیم کنید.
  7. برای تکمیل ساخت حساب سرویس روی Done کلیک کنید.
  8. روی آدرس ایمیل حساب سرویسی که ایجاد کردید کلیک کنید.
  9. روی **کلیدها** کلیک کنید.
  10. روی **افزودن کلید** و سپس روی **ایجاد کلید جدید** کلیک کنید.
  11. برای **نوع کلید**، **JSON** را انتخاب کنید.
  12. روی Create کلیک کنید و کلید خصوصی در رایانه شما بارگیری می شود.
  13. روی **Close** کلیک کنید.
  14. فایل را به پوشه کاری خود منتقل کنید و نام آن را service_account_key.json تغییر دهید.
  1. پورتال ثبت نام بدون لمس را باز کنید. شاید لازم باشد وارد شوید.
  2. روی Service accounts کلیک کنید.
  3. روی حساب سرویس پیوند کلیک کنید.
  4. آدرس ایمیل را به آدرس حساب سرویسی که ایجاد کردید تنظیم کنید.
  5. برای استفاده از حساب سرویس با حساب ثبت نام بدون لمس خود، روی پیوند حساب سرویس کلیک کنید.

مرحله 3: پروژه را آماده کنید

  1. یک پروژه جدید .NET Core C# Console Application در ویژوال استودیو ایجاد کنید.
  2. Package Manager را باز کنید، منبع بسته nuget.org را انتخاب کنید و بسته های زیر را اضافه کنید:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

برای کسب اطلاعات بیشتر، سند مایکروسافت را بخوانید و از یک بسته استفاده کنید .

مرحله 4: نمونه را تنظیم کنید

  1. service_account_key.json (در مرحله 1 دانلود شد) را به Visual Studio Solution Explorer خود بکشید.
  2. service_account_key.json را انتخاب کنید و سپس به پنجره Properties بروید و قسمت Copy to output directory را روی Always copy قرار دهید.
  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");
            }
        }
    }
}

شناسه شریک

تماس‌های API معمولاً به شناسه شریک فروشنده شما به عنوان آرگومان نیاز دارند. برای پیدا کردن شناسه شریک خود از پورتال ثبت نام بدون لمس، مراحل زیر را دنبال کنید:

  1. پورتال را باز کنید. شاید لازم باشد وارد شوید.
  2. روی Service accounts کلیک کنید.
  3. شماره شناسه شریک خود را از خط شناسه فروشنده شما کپی کنید.

مرحله 5: نمونه را اجرا کنید

برای ساخت و اجرای نمونه، روی Start در نوار ابزار ویژوال استودیو کلیک کنید.

عیب یابی

به ما بگویید چه مشکلی در شروع سریع رخ داده است و ما برای رفع آن تلاش خواهیم کرد. برای آشنایی با نحوه استفاده zero-touch از حساب‌های سرویس برای تأیید تماس‌های API، مجوز را بخوانید.

بیشتر بدانید