Bu dokümanda en iyi uygulamalara ilişkin yönergeler sunulmaktadır. Daha fazla bilgi için Performans ipuçlarına bakın.
API ne zaman kullanılır?
Programatik olarak istek göndermek için
İster iş akışınızın her bölümünü otomatikleştirmeyi ister ERP (Kurumsal Kaynak Planlama) sisteminize bağlamayı tercih edin, Content API envanteriniz değişir değişmez güncelleme göndermenize olanak tanır.
Anında geri bildirim almak için
Content API'de, veri feed'leri işlendikten sonra bir e-posta özeti üzerinden değil, her isteğe anında yanıt alırsınız. Büyük toplu istekler için beş ila on saniyelik gecikme beklenir.
Ürün verilerinizi sık sık değiştirmek için
Content API ile hızlı değişen ürün envanterinizde gün içinde birçok kez artımlı güncellemeler yapabilirsiniz. Ancak her seferinde veri feed'inizin tamamını göndermek uygun değildir. Güncellemeler tek tek kullanıma sunulursa bunları tek tek gönderin, bunları toplu olarak toplayabilmek için birkaç güncelleme olmasını beklemeyin. Benzer şekilde, güncellemeler gruplar halinde mevcutsa bunları toplu olarak gönderin, ayrı isteklere bölmeyin.
Birkaç alt hesabı yönetmek için:
Yeni oluşturulan Merchant Center hesapları, kendi ürün verilerini tutan tek hesaplardır. Çoğu durumda bu yöntem işe yarar, ancak hesabınız büyüdükçe ürünleriniz için daha karmaşık bir yönetim sistemine ihtiyaç duyabilirsiniz. Bu durum sizin için de geçerliyse çok müşterili hesap veya MCA kullanmayı düşünebilirsiniz. Bir MCA hesabının API düzeyinde yönetimi, Hesaplar hizmeti üzerinden gerçekleştirilebilir. Ayrıca, alt hesapların programatik olarak eklenmesine ve yönetilmesine olanak tanır. MCA hesabı alma hakkında daha fazla bilgiyi burada bulabilirsiniz.
API nasıl kullanılır?
Veri feed'lerini kullanıyormuş gibi API'yi kullanmayın
products kaynağını kullanırken ürün feed'inizin tamamını her gün güncellemekten kaçının.
Bunun yerine, özellikle verileri gerçekten değişen ürünleri güncelleyin. Veri feed'inizin tamamını products kaynağı aracılığıyla gönderdiğinizde hem Google hem de sizin için daha fazla zaman ve kaynak harcanır.
Yüklediğiniz ürün bilgilerini düzenli olarak almak için API'yi kullanmayın
Belirli bir Merchant Center hesabındaki ürün bilgilerini korumaktan siz sorumluysanız products.get veya products.list yöntemleri aracılığıyla Content API'den düzenli olarak ürün bilgisi istemeyin. Bu yöntemler, bilgi yükleyen müşterilerin Content API kullanan çözümler tasarlarken hataları ayıklamasına yardımcı olabilir. Ancak, bu API'ler bu tür müşterilerin ürün bilgilerini düzenli olarak alması için tasarlanmamıştır. Ürün bilgileriniz için yerel ürün veritabanı gibi başka bir kaynağınız olmalıdır ve Merchant Center'daki ürünler bu kaynağın içeriğini yansıtmalıdır.
Ürün öğelerini göndermek için hem veri feed'lerini hem de Content API'yi kullanmayın
Öğe göndermek için API'ye geçmeyi düşünüyorsanız ürün öğelerini göndermek için artık veri feed'i kullanmadığınızdan emin olun. Öğeleri her iki aracıda da göndermeye devam ederseniz beklenmedik sonuçlarla karşılaşabilirsiniz.
API ve veri feed'lerini birlikte güvenli bir şekilde kullanmamın bir yolu var mı?
API'nin Veri Feed'i Hizmeti'ni kullanarak veri feed'lerinizi değiştirebilirsiniz. Bu, geniş ölçekte veri feed'i yönetimini çok daha kolay hale getirse de beklenmedik sonuçlar ortaya çıkabileceğinden, API'yi feed'lerle aynı anda kullanarak ürün eklememeniz veya güncellememeniz gerektiğini unutmayın.
Feed'leri ve API'yi birlikte kullanmanın kabul edilebilir yöntemlerinden bazıları şunlardır:
API'den salt okunur istekler (alın veya listeleme) yürütme: Bazı satıcılar ürünleriyle ilgili bilgileri ve durum güncellemelerini almak için API'yi kullanmak ister. Ürün bilgileri yalnızca feed'ler tarafından güncellendiği için bu kabul edilebilir.
Alt hesaplarınızı (Hesaplar Hizmeti) ve/veya hesap düzeyindeki vergi ve gönderim ayarlarınızı (Accounttax Service ve Shippingsettings Hizmeti) yönetmek için API'yi kullanma. Bunlar, Datafeed'lerin sağlayabileceği işlevler değildir. Bu nedenle, bu işlevlerin yönetimi için API'nin kullanılmasıyla ilgili herhangi bir çakışma olmaz.
Veri feed'i kullanmaktan yalnızca API'ye (veya tam tersi) nasıl geçiş yapabilirim?
Şu anda veri feed'leri kullanıyorsanız ve ürünleri güncellemek için yalnızca API'ye geçmek istiyorsanız ürün verilerinizi API ile yeniden yüklemeniz gerekir. Belirli bir ürünü güncellemek için ürünler hizmetini kullandığınızda, API ürün bilgilerinin kontrolünü ele alır. Ürünün veri feed'inden silinmesi veya veri feed'inin kendisinin silinmesi, artık Merchant Center hesabınızdan ürün bilgilerinin kaldırılmasına neden olmaz. Ürünü veri feed'inden veya veri feed'inin kendisinden kaldırmak istiyorsanız veri feed'i güncellemesi olmadığından emin olun. Aksi takdirde, veri feed'i sahipliği tekrar alır ve ürünün veri feed'inden kaldırılması, ürünün kaldırılmasına neden olur.
Şu anda ürün bilgileri için yalnızca API'yi kullanıyorsanız ve veri feed'lerini birincil ürün bilgisi kaynağınız olarak kullanmak istiyorsanız yeni veri feed'ini Merchant Center hesabınıza eklemeniz yeterlidir. Bu durumda ürün, listelenen ürünlerin sahipliğini alır. Süresi dolmadan önce kaldırılmasını istediğiniz ve yalnızca API'den yüklenmiş ürünler varsa bunları Merchant Center veya API aracılığıyla silmeniz gerekir.
Content API for Shopping'i kullanarak ürünlerle birden fazla ülkeyi nasıl hedefleyebilirim?
Content API aracılığıyla gönderilen ürünler için reklamlar ve ücretsiz listelemelerle birden fazla ülkeyi hedeflemek istiyorsanız Merchant Center'daki Content API birincil feed'inde başka ülkeler yapılandırın veya products kaynağındaki shipping alanından söz konusu ülkeleri ekleyin.
Content API birincil feed ayarlarının nasıl değiştirileceğine dair bir örnek aşağıda verilmiştir.
Daha fazla bilgi için Birden fazla ülkede Alışveriş reklamlarını ve ücretsiz listelemeleri hedefleme bölümünü inceleyin.
İstemci kitaplıklarınızın güncel olduğundan emin olun
Content API ile etkileşimde bulunmak için Google istemci kitaplığı kullanıyorsanız seçtiğiniz programlama dili için paket yöneticisini kullandığınızdan ve kitaplık sürümünün güncel olduğundan emin olun. Daha fazla bilgi için Örnekler ve Kitaplıklar'da seçtiğiniz dil için geliştirici kılavuzuna bakın.
Farklı alışveriş programlarında hangi ürünlerin gösterileceğini kontrol etmek için hedefler özelliklerini kullandığınızdan emin olun
Content API, Merchant Center'da yapılandırıldığı şekliyle Content API feed'inizin varsayılan ayarlarını otomatik olarak uygular. Programa katılımı bir feed içinde veya Content API üzerinden ürün düzeyinde kontrol etmek için includedDestinations veya excludedDestinations ürün özelliklerini kullanabilirsiniz.
API feed'iniz bir programa (örneğin, Google ile Satın Al) (eski adıyla Shopping Actions) dahil edildiyse ancak belirli ürünleri hariç tutmak istiyorsanız excludedDestinations özelliğini kullanın ve değer olarak Shopping Actions değerini belirtin. Hata olmaması durumunda bu işlem, Merchant Center'daki varsayılan feed ayarlarının üzerine yazar ve ilgili öğe Google ile Satın Al'da (eski adıyla Shopping Actions) görünmez. Buna karşılık, feed'iniz bir programa (ör. Alışveriş) dahil edilmemişse değer olarak includedDestinations ve Shopping_ads özelliğini kullanarak öğeleri tek tek ekleyebilirsiniz. Böylece, öğe Alışveriş reklamlarında gösterilir.
includedDestinations ve excludedDestinations ürün özellikleri hakkında daha fazla bilgi için Yardım Merkezi'ne göz atın.
Öğeleri süreleri dolmadan güncelleyin
Bir öğe süresi dolmadan, son güncellemeden 30 gün sonra veya daha önceyse belirtilen geçerlilik bitiş tarihinde değişmezse devre dışı bırakılmasını önlemek için öğeyi güncelleyin. Hiçbir öğe değişmediği veya en son ne zaman güncellendiklerini izleyemediğiniz için çok sayıda öğeyi güncellemeniz gerekiyorsa tüm öğeleri aynı anda güncellemeyin, bunun yerine yükü birkaç güne eşit olarak dağıtın.
Content API feed'ini silmeyin. Aksi takdirde ürünleriniz kaybolabilir.
Content API üzerinden channel:online ile ilk kez bir ürün yüklediğinizde Merchant Center'da Content API başlıklı yeni bir feed gösterilir. Content API üzerinden channel:local ile ilk kez bir ürün yüklediğinizde Merchant Center'da Content API başlıklı ve Yerel Ürünler alt başlığıyla yeni bir feed gösterilir. Online veya yerel Content API feed'ini yanlışlıkla silmediğinizden emin olun. Sildiğiniz feed'e bağlı olarak, Content API aracılığıyla Merchant Center'a eklediğiniz online veya yerel ürünler kaldırılır.
Custombatch yöntemini kullanarak aynı hizmete birden fazla istek gönderme
Aynı hizmete çok sayıda sıralı veya paralel istek göndermek yerine, istenen tüm istekleri içeren tek bir özel toplu istek oluşturun. Bu şekilde, API uç noktasına istek yapılırken yaşanan gecikme, her bir istek yerine custombatch çağrısında yalnızca bir kez gerçekleşir. Bu durum, sıralı istekler yapıyorsanız özellikle önemlidir.
Tek bir toplu işlemde tek bir öğe için birden fazla güncelleme göndermeyin
Bu, güncelleme dizisiyle ilgili belirsizlik nedeniyle beklenmeyen sonuçlar doğurabilir ve çakışma hatasına neden olabilir.
Değiştirilmeyen öğeler için güncelleme gönderme
Öğelerin süresi aksi halde sona ermediği sürece yalnızca yeni, değiştirilmiş veya silinmiş ürün öğeleri için istek gönderdiğinizden emin olun.
Fiyatlar ve/veya stok durumu hızlı bir şekilde değişiyorsa Ek Feed'leri kullanın
Bir ürünün fiyat, stok durumu veya satış bilgilerini güncel tutma konusunda sorun yaşıyorsanız yalnızca bu özelliklerle ilgili güncellemeleri göndermek için products kaynağındaki Ek Feed'leri kullanabilirsiniz. Ek feed güncellemeleri küçük olduğundan belirli bir süre içinde tam ürün güncellemelerinden çok daha fazla ek feed güncellemesi yapabilirsiniz. Bu, ürünlerinizin fiyat ve stok durumunun açılış sayfalarınızla uyumlu olmasına yardımcı olur.
Ürün fiyatını ve stok durumunu güncellemenin diğer bir yolu da otomatik öğe güncellemelerini kullanmaktır. Bu bilgi, Merchant Center'daki bilgiler ile ürün açılış sayfalarındaki bilgiler arasındaki uyuşmazlıkları önlemek için API güncellemelerine ek olarak kullanılabilir. Bununla birlikte, bu özelliğin ürün fiyatı ve stok durumu doğruluğuyla ilgili küçük sorunları gidermek için tasarlandığını unutmayın. Bu nedenle, otomatik öğe güncellemeleri API aracılığıyla doğru bilgileri sağlamanın yerine geçmez.
Yenileme jetonu ne zaman kullanılır?
Yenileme jetonu, yetkilendirme isteklerinin HTTP başlığında döndürülür. Kimlik doğrulamayla ilgili çok sayıda başka bilgi içerir ancak erişim jetonlarının süresi yalnızca 60 dakika süreceğinden yenileme jetonu genellikle geliştiricilerin kullanmak istediği bir parçadır. Çünkü erişim jetonlarının süresi dolmadan önce, kullanıcıdan sürekli olarak kimlik doğrulama isteğinde bulunma ihtiyacını ortadan kaldırır.