פורסם: 15 באוקטובר 2025
החל מהיום, אנחנו משיקים גרסה חדשה (V2) של Chrome Web Store API. ממשק ה-API החדש הרבה יותר קל לשימוש, והוא תומך בתכונות כמו חשבונות שירות, כך שקל יותר לשלב אותו בתהליכי עבודה של ארגונים. הוספנו גם פונקציונליות נוספת שמאפשרת לשלוט באחוז ההשקה ולבטל באופן אוטומטי הגשות בהמתנה.
API חדש שמבוסס על משוב ממפתחים
ה-API החדש נבנה תוך התחשבות במשוב של מפתחים. פעלנו כדי שהנקודות והתשובות של ה-API יהיו אינטואיטיביות יותר.
תכונות חדשות
הוספנו גם תכונות חדשות שלא היו זמינות קודם ב-API.
גישה לסטטוס של פריטים שפורסמו וטיוטות
בעבר, היה אפשר לאחזר רק את הגרסה האחרונה של טיוטה של פריט. עכשיו אפשר לאחזר גם את הגרסה שפורסמה וגם את הגרסה בהמתנה.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
תתקבל תשובה שתכלול את הפרטים הבאים:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
ביטול שליחה בהמתנה
מעכשיו אפשר לבטל שליחה בהמתנה באמצעות ה-API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
שינוי אחוז ההשקה
עכשיו אפשר לעדכן את אחוז ההשקה של תוסף בלי לשלוח אותו לבדיקה. השינוי הזה מבוסס על משוב ממפתחים, שציינו שבגרסת ה-API הקודמת, כל עדכון, כולל עדכון של אחוז היעד, נחשב לשליחה חדשה שעוברת בדיקה בנפרד.
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 Web Store API. פשוט מוסיפים את כתובות האימייל הנדרשות במרכז השליטה למפתחים.
העברת פריט לשלב ההכנה לפרסום
בעבר, שינויים שנשלחו באמצעות ה-API תמיד פורסמו מיד אחרי שהם עברו בדיקה. מעכשיו אפשר להשתמש בשדה publishType עם הערך STAGED_PUBLISH – כשהפריט יעבור את הבדיקה, הוא יועבר להמתנה וניתן יהיה לפרסם אותו באופן ידני במועד מאוחר יותר באמצעות קריאה נוספת ל-API או באופן ידני באמצעות מרכז הבקרה למפתחים.
ארגונומיה משופרת
ממשק ה-API של חנות האינטרנט של Chrome מפרסם עכשיו מסמך גילוי. כך תוכלו ליצור אינטראקציה עם ה-API באמצעות כלים וספריות שונים של Google. בנוסף, הגדרנו בצורה ברורה יותר את המושג 'עדכוני פריטים' כמושג מרכזי ב-API, מה שמקל על השימוש ב-API ומאפשר גמישות רבה יותר לשיטות נוספות בעתיד.
שיפור התיעוד
פרסמנו תיעוד מקיף יותר של הפניות ל-API, באמצעות אותם כלים שמשמשים ל-Google APIs אחרים. האפשרות הזו כוללת גם את הלחצן 'רוצה לנסות?'. API explorer שמאפשר להגדיר בקשה אחת באמצעות פרטי כניסה מחשבון Google מאומת.
OAuth playground
עכשיו אפשר לבחור את היקף ההרשאות של Chrome Web Store API במגרש המשחקים של OAuth 2.0. כך תוכלו לקבל פרטי כניסה לבדיקה ולשלוח בקשות API לבדיקה בדפדפן. הכלי הזה תמיד תמך ב-API של חנות האינטרנט של Chrome, אבל היקפי ההרשאות ושיטות ה-API לא הוצעו באופן אוטומטי.
ספריות לקוח של Google
העדכונים האלה יאפשרו גם להשתמש ב-API בגרסאות עתידיות של ספריות הלקוח של Google API. כך יהיה קל יותר להפעיל את ה-API בשפה שתבחרו, כולל JavaScript, Node.js, Python ו-Java.
איך מבצעים את ההעברה
לרוב השיטות ב-V1 API יש שיטה מקבילה ב-V2 API. צריך לעדכן את הקוד כדי להשתמש בנקודות הקצה ובפורמט הבקשה החדשים, ולטפל בתגובות המעודכנות.
| תרחיש לדוגמה | נקודת קצה ישנה של API | נקודת קצה חדשה ל-API |
|---|---|---|
| קבלת פריט | 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 |
במדריך Use the Chrome Web Store API ובתיעוד המלא של השיטות החדשות אפשר למצוא דוגמאות לבקשות.
ה-API החדש לא תומך ביצירת פריטים חדשים. מעטים השתמשו בפונקציונליות הזו, והתועלת שלה הייתה מוגבלת כי עדיין היה צריך לספק מטא-נתונים נוספים במרכז השליטה למפתחים.
בנוסף, אנחנו כבר לא תומכים בשינוי הרשאות הגישה לפריט באמצעות ה-API. כך נוכל לוודא שהמפתח אישר את השינויים בסטטוס החשיפה במרכז השליטה למפתחים.
ציר הזמן של המעבר
אנחנו מתכננים לתמוך ב-API הישן עד 15 באוקטובר 2026. אחרי התאריך הזה, תצטרכו לעבור ל-API בגרסה 2 כדי להמשיך לשלוח בקשות.
סיכום
אנחנו שמחים לשתף איתכם את השינויים האלה. כמו תמיד, אם יש לכם משוב, אתם מוזמנים לשלוח אותו לרשימת התפוצה chromium-extensions.