تاريخ النشر: 15 أكتوبر 2025
اعتبارًا من اليوم، سنطرح إصدارًا جديدًا (الإصدار 2) من Chrome Web Store API. تتميّز واجهة برمجة التطبيقات الجديدة بسهولة استخدامها، وتتوافق مع ميزات مثل حسابات الخدمة، ما يسهّل عملية التكامل مع مهام سير العمل في المؤسسات. أضفنا أيضًا المزيد من الوظائف، مثل إمكانية التحكّم في نسبة طرح التحديث وإلغاء عمليات الإرسال المعلقة آليًا.
واجهة برمجة تطبيقات جديدة استنادًا إلى ملاحظات المطوّرين
تم إنشاء واجهة برمجة التطبيقات الجديدة مع أخذ ملاحظات المطوّرين في الاعتبار. لقد عملنا على جعل نقاط نهاية واجهة برمجة التطبيقات والردود أكثر سهولة في الاستخدام.
الميزات الجديدة
أضفنا أيضًا ميزات جديدة لم تكن متاحة في واجهة برمجة التطبيقات سابقًا.
الوصول إلى حالة العناصر المنشورة والمسودّات
في السابق، كان من الممكن استرداد أحدث مراجعة للمسودة فقط لأحد العناصر. يمكنك الآن استرداد كل من المراجعة المنشورة والمراجعة في انتظار المراجعة.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
سيؤدي ذلك إلى عرض ردّ يتضمّن ما يلي:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
إلغاء عملية إرسال معلّقة
يمكنك الآن إلغاء طلب معلّق باستخدام واجهة برمجة التطبيقات.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
تعديل النسبة المئوية لطرح الإصدار
يمكنك الآن تعديل النسبة المئوية لطرح إضافة بدون إرسالها للمراجعة. ويستند ذلك إلى الملاحظات الواردة من المطوّرين الذين أشاروا إلى أنّه في إصدار واجهة برمجة التطبيقات السابق، سيتم التعامل مع أي تحديثات، بما في ذلك النسبة المستهدَفة، على أنّها عملية إرسال جديدة ستخضع للمراجعة بشكل منفصل.
curl -H "Authorization: Bearer $TOKEN" -X POST -H "Content-Type: application/json" -d "{ "deployPercentage": 100 }" https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:setPublishedDeployPercentage
إتاحة حسابات الخدمة
يمكنك الآن منح حسابات الخدمة إذن الوصول إلى واجهة برمجة التطبيقات في "سوق Chrome الإلكتروني". ما عليك سوى إضافة عناوين البريد الإلكتروني المطلوبة في "لوحة بيانات المطوّرين".
تجهيز عنصر للنشر
في السابق، كانت تتم دائمًا عملية نشر المراجعات التي يتم إرسالها باستخدام واجهة برمجة التطبيقات فور اجتيازها المراجعة. يمكنك الآن استخدام الحقل publishType مع STAGED_PUBLISH، وعندما تتم الموافقة على تطبيقك، سيتم إعداده ويمكنك نشره يدويًا في وقت لاحق باستخدام طلب آخر من واجهة برمجة التطبيقات أو يدويًا باستخدام "لوحة بيانات المطوّر".
تصميم مريح محسّن
تنشر Chrome Web Store API الآن مستندًا للاستكشاف. يتيح لك ذلك التفاعل مع واجهة برمجة التطبيقات من خلال أدوات ومكتبات Google المختلفة. لقد حدّدنا أيضًا مفهوم مراجعات العناصر بشكل أكثر وضوحًا كمفهوم أساسي في واجهة برمجة التطبيقات، ما يسهّل استخدام واجهة برمجة التطبيقات ويتيح المزيد من المرونة لطرق إضافية في المستقبل.
مستندات محسّنة
لقد نشرنا مستندات مرجعية أكثر شمولاً حول واجهة برمجة التطبيقات، وذلك باستخدام الأدوات نفسها المستخدَمة مع واجهات برمجة تطبيقات Google الأخرى. ويشمل ذلك أيضًا الزر "تجربة". مستكشف واجهات برمجة التطبيقات الذي يتيح لك ضبط طلب واحد باستخدام بيانات الاعتماد من حسابك على Google الذي تمّت المصادقة عليه
مساحة بروتوكول OAuth
يمكنك الآن اختيار نطاق Chrome Web Store API في مساحة بروتوكول OAuth 2.0. يتيح لك ذلك الحصول على بيانات اعتماد اختبارية وإجراء طلبات اختبارية إلى واجهة برمجة التطبيقات في المتصفّح. مع أنّ هذه الأداة كانت تتيح دائمًا استخدام واجهة برمجة التطبيقات في "سوق Chrome الإلكتروني"، لم تكن النطاقات وطُرق واجهة برمجة التطبيقات تُقترح تلقائيًا.
مكتبات برامج Google
تعني هذه التعديلات أيضًا أنّ واجهة برمجة التطبيقات ستتوفّر في الإصدارات المستقبلية من مكتبات عملاء Google API. سيؤدي ذلك إلى تسهيل طلب البيانات من واجهة برمجة التطبيقات باستخدام اللغة التي تختارها، بما في ذلك JavaScript وNode.js وPython وJava.
كيفية نقل البيانات
تتضمّن معظم الطرق في الإصدار 1 من واجهة برمجة التطبيقات طريقة مكافئة في الإصدار 2 من واجهة برمجة التطبيقات. عدِّل الرمز البرمجي لاستخدام نقاط النهاية الجديدة وتنسيق الطلب، وللتعامل مع الردود المعدَّلة.
| حالة الاستخدام | نقطة النهاية القديمة لواجهة برمجة التطبيقات | نقطة نهاية جديدة لواجهة برمجة التطبيقات |
|---|---|---|
| الحصول على منتج | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| تعديل عنصر | PUT https://www.googleapis.com/upload/chromewebstore/v1.1/items/itemId |
POST https://chromewebstore.googleapis.com/upload/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:upload |
| نشر عنصر | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
يمكنك العثور على أمثلة للطلبات في البرنامج التعليمي استخدام Chrome Web Store API والمستندات الكاملة للطُرق الجديدة هنا.
لا تتيح واجهة برمجة التطبيقات الجديدة إنشاء عناصر جديدة. نادرًا ما كانت هذه الوظيفة تُستخدَم، وكانت فائدتها محدودة لأنّه كان لا يزال يجب تقديم بيانات وصفية إضافية في "لوحة بيانات المطوّر".
بالإضافة إلى ذلك، لم نعد نتيح تغيير مستوى رؤية عنصر باستخدام واجهة برمجة التطبيقات. وذلك للتأكّد من أنّ المطوّر يؤكّد أي تغييرات في مستوى الظهور في "لوحة بيانات المطوّر".
المخطّط الزمني لنقل البيانات
نخطّط لإتاحة واجهة برمجة التطبيقات القديمة حتى 15 أكتوبر 2026، وبعد ذلك عليك الانتقال إلى الإصدار 2 من واجهة برمجة التطبيقات لمواصلة إرسال الطلبات.
الخاتمة
يسرّنا أن نشاركك هذه التغييرات. وكما هو الحال دائمًا، إذا كانت لديك أي ملاحظات، يُرجى إعلامنا بها في القائمة البريدية chromium-extensions.