CSS API En İyi Uygulamaları

Bu dokümanda, CSS API'nin kullanımıyla ilgili en iyi uygulamalardan bazıları açıklanmaktadır. Bu sayfada verilen tavsiyeler, API'yi kullanmak için zorunlu değildir ancak amaçlanan kullanımların bazılarını netleştirmeye yardımcı olabilir.

Ortamınızı ayarlama

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

• Google Cloud Console'da kullanıcı ve izin JSON dosyası oluşturma
• Google Cloud Console'da CSS API'yi etkinleştirme
• Bu kullanıcıyı CSS Hesabınıza (grup veya alan) Yönetici izinleriyle ekleyin.

İstemci kitaplıkları artık çoğu programlama dilinin standart depolarında yer alıyor. Bu araçların listesini içerik kitaplığı sayfamızda bulabilirsiniz.

Başlamak için kullanabileceğiniz yöntemler

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

ListChildAccounts

ListChildAccounts, tüm CSS alanlarınızı (CSS grubu için çağrılırsa) veya satıcılarınızı (CSS alanı için çağrılırsa) 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ığını öğrendikten sonra ürün eklemeyi deneyin. Hatırlayabileceğiniz bir raw_provided_id kullandığınızdan emin olun.

• InsertCssProductInput işlevini kullanarak bir test ürünü ekleyin. Hangi özelliklerin gönderileceği konusunda yardıma ihtiyacınız varsa örnek kodumuzdan yararlanabilirsiniz.
• ListCssProducts işlevini kullanarak tüm ürünlerinizi listeleyin. Ürün eklendikten sonra görünmesi için küçük bir işleme gecikmesi olur. Bu nedenle, ürünü görmüyorsanız birkaç saniye sonra tekrar deneyin.
• cssproductinput.name öğenizi kullanarak UpdateCssProductInput işlevini kullanarak tek bir ürünü güncelleyin. Yalnızca güncellenmesi gereken özellikleri göndermeniz gerekir. Buradaki örnek koda bakın.
• DeleteCssProductInput'ı kullanarak test ürününü silin. raw_provided_id'yi 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şlemi paralel olarak birden çok kez çağırdığınızda çok daha hızlı olacağını göreceksiniz. Bu özelliği kullanmanın en iyi yolu, programlama dilinizin asynkron işlevini kullanmaktır.

Bazı programlama dillerinden örnekler:

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

Aynı anda birden fazla ürün eklemek için programlama dilinizin Async işlevini bulun ve kullanın. Sistemlerimizin aşırı yüklenmesi konusunda endişelenmenize gerek yoktur. Kota sınırları bunun içindir.

Daha fazla bilgiyi performans sayfamızda bulabilirsiniz.

Ü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 InsertCssProductInputisteğini tekrar göndererek ürünün tamamını güncelleyebilirsiniz. Şu anda, yalnızca bazı özellikler (ör. fiyat/stok durumu) değişmiş olsa bile tüm ürün verilerini göndermeniz gerekir.
• PATCH yöntemini UpdateCssProductInputkullanarak ürün adını ve ürün için güncellemek istediğiniz verileri içeren bir JSON gövdesini belirterek ürünün bazı bölümlerini güncelleyebilirsiniz. Geçerli tüm alanların sağlanmasını gerektiren InsertCssProductInput'ün aksine UpdateCssProductInput, yalnızca değiştirmek istediğiniz alanları belirtmenizi gerektirir.
• Aynı raw_provided_id ile DeleteCssProductInput'ü çağırarak bir ürünü silebilirsiniz.
• Ürünlerin süresi, son güncellemeden yaklaşık bir ay sonra otomatik olarak dolar.

Sürekli çalışma modu

Sürekli çalışma modu aşağıdaki gibi görünebilir:

• raw_provided_id olarak kendi dahili kimliklerinizi kullanın.
• Tüm ürünleri düzenli aralıklarla (ör. haftalık) yeniden yükleyin. Bu sayede, etkin ürünlerin süresi dolmaz.
• Satıcılarınızdan değişen verileri alır almaz ürünleri tek tek güncelleyin.
  • Değişikliklere hemen yanıt veremiyorsanız sık sık (belki saatte bir) değişen tüm ürünleri 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 tekliflerin sayısını 0 olarak ayarlayabilirsiniz.
  • Değişmeyen ürünleri 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 bir şekilde öne çıkarılması gerekir. Bu seçeneği, en iyi teklifinizin hızlı bir şekilde değiştiği durumlarda kullanabilirsiniz. Burada daha kararlı olan başka bir teklif seçebilirsiniz.

Bu dokümanı arada bir tekrar kontrol edin.

Bu API'nin nasıl iyileştirileceğiyle ilgili geri bildirimler aldık ve bu iyileştirmelerden 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.