מדריך למתחילים בנושא .NET למפיצים

פועלים לפי השלבים במדריך למתחילים, ותוך 10 דקות, אפליקציה פשוטה של מסוף .NET C# ששולחת בקשות להרשמה דרך הארגון ממשק ה-API של המפיץ.

דרישות מוקדמות

כדי להפעיל את המדריך למתחילים הזה, צריך:

  • חשבון Google שהוא חבר במפיץ ההרשמה דרך הארגון שלך חשבון. אם עדיין לא הצטרפתם לתוכנית, צריך לפעול לפי השלבים שמפורטים בקטע שנתחיל? המדריך לפורטל המפיצים.
  • Visual Studio מגרסה 2013 ואילך.
  • גישה לאינטרנט ודפדפן אינטרנט.

שלב 1: מפעילים את ה-API להרשמה דרך הארגון

  1. אפשר להשתמש בקישור הזה באשף ליצירה או בחירה של פרויקט ב-Google Developers Console, להפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על מעבר לפרטי הכניסה. .
  2. מגדירים את האפשרות אילו נתונים תיגש? לנתוני אפליקציה.
  3. לוחצים על הבא. אמורה להופיע בקשה ליצור שירות חשבון.
  4. נותנים לשם חשבון השירות שם תיאורי.
  5. שימו לב שמזהה חשבון השירות (הוא נראה כמו כתובת אימייל) כי להשתמש בה מאוחר יותר.
  6. מגדירים את Role ל-Service Accounts > Service Account User.
  7. לוחצים על Done כדי לסיים ליצור את חשבון השירות.
  8. לוחצים על כתובת האימייל של חשבון השירות שנוצר.
  9. לוחצים על **מפתחות**.
  10. לוחצים על **הוספת מפתח** ואז על **יצירת מפתח חדש**.
  11. בקטע 'סוג מפתח', בוחרים באפשרות 'JSON'.
  12. לוחצים על יצירה ואז על הורדת המפתח הפרטי למחשב.
  13. לוחצים על **סגירה**.
  14. צריך להעביר את הקובץ לספריית העבודה ולשנות את השם שלו ל-service_account_key.json.
  1. פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
  2. לחץ על שירות חשבונות.
  3. לוחצים על קישור חשבון השירות.
  4. מגדירים את Email address לכתובת של חשבון השירות שיצרתם.
  5. לוחצים על קישור חשבון שירות כדי להשתמש בחשבון השירות דרך ארגון ללא מגע. חשבון הרישום.

שלב 3: הכנת הפרויקט

  1. יוצרים פרויקט חדש של אפליקציית המסוף בפורמט .NET Core C# ב-Visual Studio.
  2. פותחים את מנהל החבילות, בוחרים את מקור החבילה nuget.org ומוסיפים את החבילות הבאות:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

מידע נוסף זמין במסמך של Microsoft בנושא התקנה ושימוש בחבילה.

שלב 4: הגדרת הדוגמה

  1. גוררים את service_account_key.json (שהורדתם בשלב 1) לפריט החזותי חוקר פתרונות של Studio.
  2. בוחרים באפשרות service_account_key.json, עוברים לחלון 'מאפיינים' ו מגדירים את השדה Copy to Output Directory (העתקה לספריית הפלט) כתמיד להעתיק.
  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. לחץ על שירות חשבונות.
  3. מעתיקים את המספר של מזהה השותף מהשורה מזהה המפיץ שלך.

שלב 5: הרצת הדוגמה

כדי ליצור ולהריץ את הדוגמה, לוחצים על Start בסרגל הכלים של Visual Studio.

פתרון בעיות

אפשר לספר לנו מה השתבש עם המדריך למתחילים, וננסה לעזור כדי לפתור את הבעיה. במאמר הרשאה מוסבר איך שירות zero-touch משתמש בחשבונות שירות כדי לאשר קריאות ל-API.

מידע נוסף