واجهة برمجة تطبيقات إرسال مركز الشركاء لدمج تطبيقات Azure في مركز الشركاء

  • مقالة
  • قراءة خلال 3 دقائق

استخدم واجهة برمجة تطبيقات الإرسال في مركز الشركاء للاستعلام برمجيا وإنشاء عمليات إرسال ونشر عروض Azure. تعد واجهة برمجة التطبيقات هذه مفيدة إذا كان حسابك يدير العديد من العروض وتريد أتمتة عملية الإرسال لهذه العروض وتحسينها.

متطلبات API الأساسية

هناك بعض الأصول البرمجية التي تحتاجها لاستخدام واجهة برمجة تطبيقات مركز الشركاء لمنتجات Azure:

  • a Azure Active Directory application.
  • a Azure Active Directory (Azure AD) access token.

الخطوة 1: إكمال المتطلبات الأساسية لاستخدام واجهة برمجة تطبيقات التقديم في مركز الشركاء

قبل البدء في كتابة التعليمات البرمجية للاتصال بواجهة برمجة تطبيقات التقديم في مركز الشركاء، تأكد من إكمال المتطلبات الأساسية التالية.

  • يجب أن يكون لديك (أو مؤسستك) دليل Azure AD ويجب أن يكون لديك إذن مسؤول عمومي للدليل. إذا كنت تستخدم بالفعل Microsoft 365 أو خدمات أعمال أخرى من Microsoft، فهذا يعني أن لديك بالفعل دليل Azure AD. وإلا، يمكنك إنشاء Azure AD جديد في مركز الشركاء دون أي رسوم إضافية.

  • يجب عليك إقران تطبيق Azure AD بحسابك في مركز الشركاء والحصول على معرف المستأجر ومعرف العميل والمفتاح. تحتاج إلى هذه القيم للحصول على رمز وصول Azure AD، والذي ستستخدمه في المكالمات إلى واجهة برمجة تطبيقات الإرسال Microsoft Store.

كيفية إقران تطبيق Azure AD بحسابك في مركز الشركاء

لاستخدام واجهة برمجة تطبيقات الإرسال Microsoft Store، يجب عليك إقران تطبيق Azure AD بحسابك في مركز الشركاء، واسترداد معرف المستأجر ومعرف العميل للتطبيق، وإنشاء مفتاح. يمثل تطبيق Azure AD التطبيق أو الخدمة التي تريد الاتصال من خلالها بواجهة برمجة تطبيقات إرسال مركز الشركاء. تحتاج إلى معرف المستأجر ومعرف العميل والمفتاح للحصول على رمز وصول Azure AD الذي تمرره إلى واجهة برمجة التطبيقات.

ملاحظة

تحتاج فقط إلى تنفيذ هذه المهمة مرة واحدة. بعد حصولك على معرف المستأجر ومعرف العميل والمفتاح، يمكنك إعادة استخدامها في أي وقت تحتاج فيه إلى إنشاء رمز مميز جديد للوصول إلى Azure AD.

  1. في "مركز الشركاء"، اربط حساب "مركز الشركاء" الخاص بمؤسستك بدليل Azure AD الخاص بمؤسستك.
  2. بعد ذلك، من صفحة المستخدمون في قسم إعدادات الحساب في مركز الشركاء، أضف تطبيق Azure AD الذي يمثل التطبيق أو الخدمة التي ستستخدمها للوصول إلى عمليات الإرسال لحسابك في مركز الشركاء. تأكد من تعيين دور المدير لهذا التطبيق. إذا لم يكن التطبيق موجودا بعد في دليل Azure AD، فيمكنك إنشاء تطبيق Azure AD جديد في مركز الشركاء.
  3. ارجع إلى صفحة المستخدمون ، وانقر فوق اسم تطبيق Azure AD للانتقال إلى إعدادات التطبيق، وانسخ قيمتي معرف المستأجرومعرف العميل .
  4. انقر على إضافة مفتاح جديد. في الشاشة التالية، انسخ قيمة المفتاح لأسفل. لن تتمكن من الوصول إلى هذه المعلومات مرة أخرى بعد مغادرة هذه الصفحة. لمزيد من المعلومات، راجع إدارة المفاتيح لتطبيق Azure AD.

الخطوة 2: الحصول على رمز وصول Azure AD

قبل استدعاء أي من الطرق الموجودة في واجهة برمجة تطبيقات إرسال مركز الشركاء، يجب عليك أولا الحصول على رمز وصول Azure AD الذي تمرره إلى رأس التفويض لكل طريقة في واجهة برمجة التطبيقات. بعد الحصول على رمز مميز للوصول، لديك 60 دقيقة لاستخدامه قبل انتهاء صلاحيته. بعد انتهاء صلاحية الرمز المميز، يمكنك تحديث الرمز المميز حتى تتمكن من الاستمرار في استخدامه في المكالمات المستقبلية إلى واجهة برمجة التطبيقات.

للحصول على الرمز المميز للوصول، اتبع الإرشادات الواردة في مكالمات الخدمة إلى الخدمة باستخدام بيانات اعتماد العميل لإرسال رسالة HTTP POST إلى https://login.microsoftonline.com/<tenant_id>/oauth2/token نقطة النهاية. فيما يلي طلب عينة:

JSONCopy

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

بالنسبة إلى القيمة tenant_id في معلمتي client_idclient_secret، حدد معرف المستأجر ومعرف العميل ومفتاح التطبيق الذي قمت باسترداده من "مركز الشركاء" في POST URI القسم السابق. بالنسبة لمعلمة المورد ، يجب عليك تحديد https://api.partner.microsoft.com.

الخطوة 3: استخدام واجهة برمجة تطبيقات إرسال Microsoft Store

بعد أن يكون لديك رمز مميز للوصول إلى Azure AD، يمكنك الاتصال بالطرق في واجهة برمجة تطبيقات إرسال مركز الشركاء. لإنشاء عمليات إرسال أو تحديثها، عادة ما تستدعي طرقا متعددة في واجهة برمجة تطبيقات إرسال مركز الشركاء بترتيب معين. للحصول على معلومات حول كل سيناريو وبناء جملة كل طريقة، راجع Ingestion API Swagger.

https://ingestionapi-swagger.azureedge.net/#/

الخطوات التالية