شروع کنید

قبل از استفاده از کتابخانه مشترک Reseller Android، نمایندگان فروش باید به برنامه استقرار Knox سامسونگ و ثبت نام بدون لمس اندروید بپیوندند.

برنامه استقرار ناکس (KDP)

مراحل زیر را دنبال کنید تا به KDP بپیوندید و جزئیات لازم را برای شروع استفاده از کتابخانه فروشنده بازیابی کنید.

مرحله 1: برای KDP ثبت نام کنید

1. برای ثبت نام در KDP از Samsung Knox for Resellers دیدن کنید.
2. یک حساب سامسونگ ایجاد کنید و برای یک حساب Samsung Knox به عنوان فروشنده ثبت نام کنید.
3. پس از تأیید حساب فروشنده خود، به پورتال KDP وارد شوید تا resellerId خود را پیدا کنید.

مرحله 2: درخواست دسترسی به پورتال Knox Cloud API

1. برای دسترسی به پورتال Knox Cloud API درخواستی به سامسونگ ارسال کنید.
2. به پورتال Knox Cloud API وارد شوید.

مرحله 3: کلیدهای حساب سرویس و clientIdentifier دریافت کنید

1. فایل JSON جفت کلید را از پورتال Knox Cloud API دانلود کرده و در مکانی امن ذخیره کنید.
2. clientIdentifier منحصر به فرد خود را از پورتال Knox Cloud API ایجاد کنید.

مرحله 4: شی SamsungResellerService را ایجاد کنید

از مسیر فایل JSON، clientIdentifier ، resellerId برای ایجاد شی SamsungResellerService برای استفاده از کتابخانه مشترک استفاده کنید.

ثبت نام بدون لمس

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

1. در داخل هواپیما با ثبت نام بدون لمس .
2. از آنجایی که Common Reseller Library Android از Reseller API استفاده می‌کند، باید از مشاور راه‌حل‌های Google Platform درخواست دسترسی به API Reseller را بدهید.
3. درخواست دسترسی به پورتال صفر لمسی.

با همان حساب Google که برای دسترسی به پورتال استفاده می‌کنید، دستورالعمل‌های باقیمانده را برای ایجاد یک حساب سرویس و فعال کردن Reseller API دنبال کنید.

مرحله 2: یک حساب کاربری ایجاد کنید

یک حساب سرویس، که گاهی اوقات یک حساب ربات نامیده می شود، یک حساب Google است که به جای کاربران، برنامه ها را نشان می دهد. از آنجا که کتابخانه ثبت نام از طرف حساب سرویس با Google API تماس می گیرد، از کنسول API Google برای تنظیم دسترسی استفاده کنید.

یک پروژه کنسول API ایجاد کنید

ایجاد یک پروژه و حساب سرویس جدید کنسول API، تمرین خوبی است. این امر مدیریت دسترسی، مدیریت منابع و تعمیر کلیدهای گم شده را در آینده آسان تر می کند. برای ایجاد یک پروژه جدید در Google API Console، مراحل زیر را دنبال کنید:

1. به کنسول API بروید.
2. از لیست پروژه ها، ایجاد پروژه را انتخاب کنید.
3. نامی وارد کنید که برنامه و ثبت نام بدون لمس شما را توصیف کند.
4. شناسه پروژه را مشخص کنید یا پیش فرض را بپذیرید.
5. روی ایجاد کلیک کنید.

برای کسب اطلاعات بیشتر، سند Google Cloud Platform را مدیریت پروژه‌ها در کنسول بخوانید.

افزودن اعتبار خدمات جدید

برای افزودن اعتبار جدید و یک حساب سرویس به پروژه خود، مراحل زیر را در کنسول API خود دنبال کنید.

1. صفحه حساب‌های سرویس را باز کنید. اگر از شما خواسته شد، یک پروژه را انتخاب کنید.
2. روی ایجاد حساب سرویس کلیک کنید، نام و توضیحاتی را برای حساب سرویس وارد کنید. می‌توانید از شناسه حساب پیش‌فرض سرویس استفاده کنید یا یک شناسه متفاوت و منحصر به فرد را انتخاب کنید. پس از اتمام روی Create کلیک کنید.
3. بخش مجوزهای حساب سرویس (اختیاری) که در زیر آمده است مورد نیاز نیست. روی Continue کلیک کنید.
4. در صفحه Grant users access to this service account account ، به قسمت Create key بروید. روی کلید ایجاد کلیک کنید.
5. در پانل کناری که ظاهر می شود، قالب کلید خود را انتخاب کنید: JSON توصیه می شود.
6. روی ایجاد کلیک کنید. جفت کلید عمومی/خصوصی جدید شما تولید و در دستگاه شما دانلود می شود. به عنوان تنها کپی این کلید عمل می کند. برای اطلاعات در مورد نحوه ذخیره ایمن آن، به مدیریت کلیدهای حساب سرویس مراجعه کنید.
7. روی Close روی کلید خصوصی ذخیره شده در گفتگوی رایانه خود کلیک کنید، سپس روی Done کلیک کنید تا به جدول حساب های خدمات خود بازگردید.

آدرس ایمیل حساب سرویس را کپی کنید و آن را در دسترس داشته باشید. بعداً وقتی حساب سرویس را به سازمان خود پیوند می دهید به آن نیاز دارید.

مرحله 3: فایل کلید JSON را ذخیره کنید

کنسول API یک جفت کلید خصوصی جدید ایجاد می کند که برای احراز هویت تماس های API انجام شده با استفاده از حساب سرویس شما استفاده می شود. کلید خصوصی در فایل کلید JSON که دانلود می کنید وجود دارد.

شما باید کلید را خصوصی نگه دارید، بنابراین آن را در کد منبع نرم افزار خود وارد نکنید. اگر فایل کلید را گم کردید، باید یک جفت کلید جدید ایجاد کنید.

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

مرحله 4: API را فعال کنید

قبل از اینکه کتابخانه بتواند از Reseller API استفاده کند، باید آن را فعال کنید. فعال کردن یک API آن را با پروژه کنسول API فعلی مرتبط می کند و صفحات نظارتی را در کنسول شما اضافه می کند.

برای فعال کردن Reseller API، مراحل زیر را در کنسول API خود دنبال کنید:

1. APIs & Services > Library را کلیک کنید.
2. از فیلد جستجو برای یافتن Android Device Provisioning Partner API استفاده کنید.
3. روی Android Device Provisioning Partner API کلیک کنید.
4. روی Enable کلیک کنید.

پس از یک تاخیر کوتاه، وضعیت API به فعال تغییر می کند. اگر Android Device Provisioning Partner API را نمی‌بینید، بررسی کنید که سازمان شما وارد ثبت‌نام بدون لمس شده باشد. مطمئن شوید که از یک حساب Google برای ثبت نام بدون لمس و Google API Console استفاده می کنید. از مشاور راهکارهای پلتفرم Google خود بخواهید بررسی کند که آیا حساب Google شما به API دسترسی دارد یا خیر.

مرحله 5: حساب سرویس را پیوند دهید

پیوند دادن حساب سرویس با حساب ثبت نام بدون لمس سازمان شما به حساب سرویس اجازه می دهد تا از طرف سازمان شما تماس های API برقرار کند. برای پیوند دادن حساب سرویس خود مراحل زیر را دنبال کنید:

1. پورتال ثبت نام بدون لمس را باز کنید. شاید لازم باشد وارد شوید.
2. روی Service accounts کلیک کنید.
3. حساب سرویس پیوند کلیک کنید.
4. آدرس ایمیل را به آدرس حساب سرویسی که ایجاد کردید تنظیم کنید.
5. برای استفاده از حساب سرویس با حساب ثبت نام بدون لمس خود ، روی پیوند حساب سرویس کلیک کنید.

اگر آدرس ایمیل حساب سرویسی که ایجاد کرده‌اید را پیدا نکردید، آن را از یکی از مکان‌های زیر کپی کنید:

• شناسه حساب سرویس از صفحه حساب‌های سرویس در Google API Console.
• فیلد ویژگی client_email در فایل کلید JSON.

اکنون می توانید از حساب سرویس خود با کتابخانه ثبت نام برای ایجاد اشیاء ResellerService استفاده کنید.

کتابخانه مشترک Reseller Android را به پروژه Gradle اضافه کنید

این کتابخانه به عنوان یک مخزن Maven در دسترس است. برای افزودن کتابخانه به پروژه Gradle جدید مراحل زیر را دنبال کنید:

1. برای ایجاد یک پروژه جدید دستور زیر را اجرا کنید:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. فایل service_account_key.json را که در مرحله 2 دانلود کردید در دایرکتوری src/main/resources/ که در بالا ایجاد کردید کپی کنید.

3. فایل پیش فرض build.gradle را باز کنید و مخزن مرکزی Maven را برای ساخت خود اعلام کنید:

   repositories {
       mavenCentral()
   }
   

4. در همان فایل، وابستگی زیر را اضافه کنید:

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

اکنون پروژه شما باید بتواند از کتابخانه مشتری برای ثبت نام دستگاه های Android استفاده کند.

---

مراحل بعدی: عملیات مشترک