Yayınlanma tarihi: 15 Ekim 2025
Bugünden itibaren Chrome Web Mağazası API'sinin yeni bir sürümünü (V2) yayınlıyoruz. Yeni API'nin kullanımı çok daha kolaydır ve hizmet hesapları gibi özellikleri destekleyerek kurumsal iş akışlarıyla entegrasyonu kolaylaştırır. Ayrıca, yüzde olarak kullanıma sunma işlemini kontrol etme ve bekleyen gönderimleri programatik olarak iptal etme olanağı sunan işlevler de ekledik.
Geliştirici geri bildirimlerine dayalı yeni bir API
Yeni API, geliştiricilerden gelen geri bildirimler dikkate alınarak oluşturuldu. API uç noktalarını ve yanıtlarını daha sezgisel hale getirmek için çalıştık.
Yeni özellikler
Ayrıca, daha önce API'de bulunmayan yeni özellikler de ekledik.
Yayınlanmış ve taslak öğe durumuna erişim
Daha önce, bir öğenin yalnızca en son taslak düzeltmesini almak mümkündü. Artık hem yayınlanmış hem de bekleyen düzeltmeyi alabilirsiniz.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Bu işlem, aşağıdakileri içeren bir yanıt döndürür:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Beklemedeki bir gönderimi iptal etme
Artık API'yi kullanarak bekleyen bir gönderimi iptal edebilirsiniz.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Kullanıma sunma yüzdesini değiştirme
Artık bir uzantının kullanıma sunma yüzdesini, incelemeye göndermeden güncelleyebilirsiniz. Bu değişiklik, geliştiricilerin geri bildirimlerine dayanmaktadır. Geliştiriciler, önceki API sürümünde hedef yüzde de dahil olmak üzere tüm güncellemelerin ayrı olarak incelemeye tabi tutulacak yeni bir gönderim olarak değerlendirildiğini belirtmişti.
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
Hizmet hesabı desteği
Artık Chrome Web Mağazası API'sine hizmet hesaplarının erişmesine izin verebilirsiniz. Gerekli e-posta adreslerini Geliştirici Kontrol Paneli'ne eklemeniz yeterlidir.
Öğeyi yayınlanmaya hazırlama
Daha önce, API kullanılarak gönderilen düzeltmeler, incelemeyi geçtikten sonra her zaman anında yayınlanıyordu. Artık publishType alanını STAGED_PUBLISH ile birlikte kullanabilirsiniz. Öğeniz incelemeden geçtikten sonra hazırlanır ve başka bir API çağrısı kullanılarak veya Geliştirici Kontrol Paneli'nden manuel olarak daha sonra yayınlanabilir.
Daha iyi ergonomi
Chrome Web Mağazası API'si artık bir keşif dokümanı yayınlıyor. Bu sayede, çeşitli Google araçları ve kitaplıkları aracılığıyla API ile etkileşimde bulunabilirsiniz. Ayrıca, API'de öğe revizyonları kavramını daha net bir şekilde tanımladık. Bu sayede API'nin kullanımı kolaylaştı ve gelecekte ek yöntemler için daha fazla esneklik sağlandı.
İyileştirilmiş dokümanlar
Diğer Google API'leri için kullanılan araçlarla çok daha kapsamlı bir API referans dokümanı yayınladık. "Deneyin!" seçeneği de bu kapsamdadır. Kimliği doğrulanmış Google Hesabınızdaki kimlik bilgilerini kullanarak tek bir istek yapılandırmanıza olanak tanıyan API Gezgini.
OAuth oyun alanı
Artık OAuth 2.0 Playground'da Chrome Web Mağazası API kapsamını seçebilirsiniz. Bu sayede, test kimlik bilgilerini alabilir ve tarayıcıda test API istekleri gönderebilirsiniz. Bu araç her zaman Chrome Web Mağazası API'sini desteklese de kapsamlar ve API yöntemleri otomatik olarak önerilmiyordu.
Google istemci kitaplıkları
Bu güncellemeler, API'nin Google API istemci kitaplıklarının gelecekteki sürümlerinde de kullanılabileceği anlamına gelir. Bu sayede, JavaScript, Node.js, Python ve Java gibi tercih ettiğiniz dilde API'yi çağırmak kolaylaşır.
Taşıma işlemi nasıl yapılır?
V1 API'deki çoğu yöntemin V2 API'de eşdeğer bir yöntemi vardır. Yeni uç noktaları ve istek biçimini kullanmak, güncellenen yanıtları işlemek için kodunuzu güncelleyin.
| Kullanım alanı | Eski API uç noktası | Yeni API uç noktası |
|---|---|---|
| Öğe alma | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Öğe güncelleme | 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 |
| Öğe yayınlama | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Örnek istekleri Chrome Web Mağazası API'sini kullanma eğitiminde ve yeni yöntemlerin tam belgelerinde bulabilirsiniz.
Yeni API, yeni öğe oluşturmayı desteklemez. Bu işlev nadiren kullanılıyordu ve ek meta verilerin Geliştirici Kontrol Paneli'nde sağlanması gerektiği göz önüne alındığında sınırlı bir fayda sağlıyordu.
Ayrıca, artık API kullanarak bir öğenin görünürlüğünü değiştirme özelliği desteklenmemektedir. Bunun amacı, görünürlükle ilgili tüm değişikliklerin Geliştirici Panosu'nda geliştirici tarafından onaylanmasını sağlamaktır.
Taşıma zaman çizelgesi
Eski API'yi 15 Ekim 2026'ya kadar desteklemeyi planlıyoruz. Bu tarihten sonra istekte bulunmaya devam etmek için V2 API'ye geçmeniz gerekecek.
Özet
Bu değişiklikleri sizinle paylaşmaktan büyük heyecan duyuyoruz. Her zaman olduğu gibi, geri bildiriminiz olursa lütfen chromium-extensions posta listesinde bize bildirin.