CSS API En İyi Uygulamaları

Bu belgede, CSS API'nin kullanımıyla ilgili bazı en iyi uygulamalar açıklanmaktadır. Bu sayfada verilen tavsiyeler, API'nin kullanımı için zorunlu değildir ancak amaçlanan kullanımın bazı yönlerini netleştirmeye yardımcı olabilir.

Ortamınızı ayarlama

Geliştirme ortamınızı kurmak için Hızlı Başlangıç dokümanında verilen adımları uygulayın.

• Google Cloud Console'da kullanıcı ve izinler JSON dosyası oluşturma
• Google Cloud Console'da CSS API'yi etkinleştirme
• Bu kullanıcıyı, yönetici izinleriyle CSS hesabınıza (CSS grubu veya CSS alanı) ekleyin.
• Doğru OAuth kapsamını kullandığınızı doğrulayın: https://www.googleapis.com/auth/content

İstemci kitaplıkları artık çoğu programlama dilinin standart depolarında yer alıyor. Bunların listesini istemci kitaplığı sayfamızda bulabilirsiniz.

Doğru kimlikleri kullanma

Doğru API uç noktalarıyla doğru kimlikleri kullanın:

• CSS API (css.googleapis.com): CSS ürünleriyle (ör. accounts/{cssDomainId}/cssProductInputs:insert).
• Merchant API (merchantapi.googleapis.com): Standart satıcı ürünleri için Merchant API'yi kullanın.

Bunların karıştırılması hatalara yol açar. Daha fazla bilgi için CSS API'ye Genel Bakış başlıklı makaleyi inceleyin.

Başlamak için iyi yöntemler

Aşağıdaki yöntemlerle test yapmanızı öneririz:

ListChildAccounts

ListChildAccounts, CSS alanlarınızın (bir CSS grubu için çağrılıyorsa) veya satıcılarınızın (bir CSS alanı için çağrılıyorsa) tümünü listeleyen salt okunur bir çağrıdır. Bu nedenle, her şeyin doğru şekilde ayarlanıp ayarlanmadığını test etmek için iyi bir yöntemdir.

Ürün ekleme/listeleme/güncelleme/silme

API'nin çalıştığından emin olduktan sonra ürün eklemeyi deneyin. Hatırlayacağınız bir raw_provided_id kullandığınızdan emin olun.

• InsertCssProductInput kullanarak bir test ürünü ekleyin. Hangi özellikleri göndereceğiniz konusunda yardıma ihtiyacınız olursa örnek kodumuzdan yararlanabilirsiniz.
• ListCssProducts kullanarak tüm ürünlerinizi listeleyin. Bir ürün eklenmesinden sonra gösterilmeden önce kısa bir işleme gecikmesi yaşanır. Bu nedenle, ürünü görmüyorsanız birkaç saniye sonra tekrar deneyin.
• cssproductinput.name'nizi kullanarak UpdateCssProductInput ile tek bir ürünü güncelleyin. Yalnızca güncellenmesi gereken özellikleri göndermeniz gerekir. Örnek kodu buradan inceleyebilirsiniz.
• DeleteCssProductInput kullanarak test ürününü silin. raw_provided_id özelliğini kullanmanız gerekir.

Performansı artırmak için Async'i kullanma

CSS API, paralel çağrılar için tasarlanmıştır. Tek işlemlerin performansının yavaş olabileceğini ancak aynı işlem birden çok kez paralel olarak çağrıldığında çok daha hızlı olacağını göreceksiniz. Bu özelliği kullanmanın en iyi yolu, programlama dilinizin asenkron işlevini kullanmaktır.

Bazı programlama dillerinden örnekler:

• Java için insertCssProductInputCallable().futureCall() işlevini kullanın.
• Python için CssProductInputsServiceAsyncClient'ı kullanın.
• C# için InsertCssProductInputAsync kullanın.

Aynı anda birden fazla ürün eklemek için programlama dilinizin Async işlevini bulup kullanın. Kota sınırları, sistemlerimizin aşırı yüklenmesini önlemek için belirlenir. Bu nedenle, sistemlerimizin aşırı yüklenmesi konusunda endişelenmenize gerek yoktur.

Daha fazla bilgiyi performans sayfamızda bulabilirsiniz.

Yüklerinizi Doğrulama

Sık karşılaşılan hatalardan kaçınmak için JSON yüklerinizin doğru şekilde biçimlendirildiğini doğrulayın:

• Resmi Dokümanlara Başvurun: Alan tanımları, numaralandırmalar, veri türleri ve yük yapısı için her zaman en son CSS API referansına bakın.
• Örnek Yükleri İnceleme: Yüklerinizdeki tutarsızlıkları belirlemek için yüklerinizi sağlanan kod örnekleriyle karşılaştırın.
• Veri Türleri: Belgelerde belirtildiği gibi doğru veri türlerini (ör. dizeler, nesneler, diziler) kullandığınızdan emin olun.
• Aşamalı olarak test edin: Temel bağlantıyı onaylamak için minimum sayıda geçerli yükle başlayın ve yavaş yavaş daha fazla özellik ekleyin.

Ürünü güncelleme

Yüklenen ürünler güncellenene, silinene veya süresi dolana kadar sistemimizde kalır.

• Başlangıçta kullandığınız raw_provided_id ile aynı InsertCssProductInput isteğini tekrar göndererek ürünün tamamını güncelleyebilirsiniz. Şimdilik, yalnızca bazı özellikler (ör. fiyat/stok durumu) değişmiş olsa bile tüm ürün verilerini göndermeniz gerekir.
• PATCH yöntemini UpdateCssProductInput kullanarak ürün adını ve ürünle ilgili güncellemek istediğiniz verileri içeren bir JSON gövdesini belirterek ürünün bazı bölümlerini güncelleyebilirsiniz. Tüm geçerli alanların sağlanmasını gerektiren InsertCssProductInput yönteminin aksine, UpdateCssProductInput yalnızca değiştirmek istediğiniz alanları belirtmenizi gerektirir.
• Aynı raw_provided_id ile DeleteCssProductInput numaralı telefonu arayarak bir ürünü silebilirsiniz.
• Ürünlerin geçerliliği, son güncellemeden yaklaşık bir ay sonra otomatik olarak sona erer.

Sürekli çalışma modu

Sürekli işlem modu aşağıdaki gibi görünebilir:

• raw_provided_id olarak kendi dahili kimliklerinizi kullanın.
• Tüm ürünleri düzenli olarak (ör. haftalık) yeniden yükleyin. Bu sayede etkin ürünlerin süresi dolmaz.
• Değiştirilen verileri satıcılarınızdan alır almaz tek tek ürünleri güncelleyin.
  • Değişikliklere hemen tepki veremiyorsanız tüm değişen ürünleri sık sık (ör. saatte bir) bulun ve yalnızca bu ürünleri yeniden yükleyin.
  • Artık mevcut olmayan ürünler için silme çağrısını kullanabilir veya mevcut teklif sayısını 0 olarak ayarlayabilirsiniz.
  • Değişmeyen ürünleri bize sık sık göndermeyin. Bu çağrılar, API kotanızdan düşülür. Haftalık yenileme yeterlidir.

Başlıktaki teklif seçimi

Başlıktaki teklifin, sitenizdeki en iyi veya en ucuz teklif olması gerekmez ancak belirgin şekilde öne çıkarılması gerekir. Bu özelliği, en iyi teklifinizin hızlı değiştiği durumlarda kullanabilirsiniz. Bu durumda, daha sabit olan başka bir teklif seçebilirsiniz.

Bu belgeyi zaman zaman yeniden kontrol edin.

Bu API'yi nasıl iyileştirebileceğimiz konusunda geri bildirimler aldık ve bu iyileştirmelerin bazılarını kullanıma sunmak için çalışıyoruz. CSS API'nin kullanımını basitleştirecek yeni özellikler kullanıma sunulduğunda bu sayfa güncellenecektir.