Bu dokümanda, en iyi uygulamalarla ilgili yönergeler sağlanmaktadır. Daha fazla bilgi için Performansla ilgili ipuçları başlıklı makaleyi inceleyin.
API ne zaman kullanılır?
İstekleri programatik olarak göndermek için
İş akışınızın her bölümünü otomatikleştirmeyi veya ERP (Kurumsal Kaynak Planlama) sisteminize bir bağlantı oluşturmayı tercih ederseniz 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 e-posta özeti yerine her istek için anında yanıt alırsınız. Büyük toplu istekler için beş ila on saniyelik bir gecikme beklenir.
Ürün verilerinizi sık sık değiştirmek için
Content API ile, hızlı hareket eden ürün envanterinizde günde birçok kez kademeli güncellemeler yapabilirsiniz. Ancak her seferinde veri feed'inizin tamamını göndermek mümkün değildir. Güncellemeler tek tek yayınlanırsa bunları tek tek gönderin. Birden fazla güncelleme gelene kadar beklemeyin. Benzer şekilde, güncellemeler toplu olarak mevcutsa bunları tek tek isteklere ayırmayın, toplu olarak gönderin.
Birden fazla alt hesabı yönetmek için
Yeni oluşturulan Merchant Center hesapları, kendi ürün veri kümesini barındıran tekil hesaplardır. Bu yöntem çoğu durumda 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 geçerliyse çok müşterili hesap (MCA) kullanmayı düşünebilirsiniz. MCA hesabının API düzeyinde yönetimi, Hesaplar hizmeti aracılığıyla yapılabilir ve alt hesapların programatik olarak eklenmesine ve yönetilmesine olanak tanır. MCA hesabı edinme hakkında daha fazla bilgiyi burada bulabilirsiniz.
API nasıl kullanılır?
API'yi veri feed'leri gibi kullanmayın
products kaynağını kullanırken ürün feed'inizin tamamının günlük olarak güncellenmesini önleyin.
Bunun yerine, yalnızca verileri gerçekten değişen ürünleri güncelleyin. Veri feed'inizin tamamını products kaynağı üzerinden göndermek hem Google hem de sizin için daha fazla zaman ve kaynak tüketir.
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 yönetmekten sorumluysanız products.get veya products.list yöntemleriyle düzenli olarak Content API'den ürün bilgisi istemeyin. Bilgi yükleyen istemciler için bu yöntemler, Content API'yi kullanan çözümler tasarlarken sorunlarda hata ayıklamanıza 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 bir ü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 artık ürün öğelerini göndermek için veri feed'leri kullanmadığınızdan emin olun. Her iki mecrada da öğe göndermeye devam ederseniz beklenmedik sonuçlar oluşabilir.
API'yi ve veri feed'lerini birlikte güvenli bir şekilde kullanabilir miyim?
API'nin Veri Feed'i Hizmeti'ni kullanarak veri feed'lerinizi değiştirebilirsiniz. Bu, büyük ölçekte veri feed'i yönetimini çok daha kolay hale getirse de beklenmedik sonuçlar ortaya çıkabileceğinden, API'yi feed'lerle eşzamanlı olarak kullanarak ürün eklememenizi veya güncellememenizi öneririz.
Feed'leri ve API'yi birlikte kullanmanın kabul edilebilir diğer yollarına örnek olarak şunlar verilebilir:
API'den salt okunur istekler (get veya list) yürütme: Bazı satıcılar, ürünlerine ilişkin bilgi ve durum güncellemelerini almak için API'yi kullanmak ister. Ürün bilgileri yalnızca feed'ler tarafından güncellendiğinden bu kabul edilebilir.
API'yi kullanarak alt hesaplarınızı (AccountsService) ve/veya hesap düzeyindeki vergi ve gönderim ayarlarınızı (AccounttaxService ve ShippingsettingsService) yönetme Bunlar, veri feed'lerinin sağlayabileceği işlevler değildir. Bu nedenle, bu işlevleri yönetmek için API'nin kullanılmasında herhangi bir çakışma yoktur.
Veri feed'lerini kullanmayı yalnızca API'yi kullanmaya veya tam tersini nasıl geçirebilirim?
Şu anda veri feed'leri kullanıyorsanız ve ürünleri güncellemek için yalnızca API'yi kullanmaya geçmek istiyorsanız ürün verilerinizi API ile yeniden yüklemeniz gerekir. Belirli bir ürünü güncellemek için ürün hizmetini kullandığınızda API, ürün bilgilerinin kontrolünü devralır. Ürünü veri feed'inden veya veri feed'inin kendisini silmek artık ürün bilgilerini Merchant Center hesabınızdan kaldırmaz. Ürünü veri feed'inden veya feed'in kendisinden kaldırmak istiyorsanız veri feed'inde güncelleme 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 birincil ürün bilgileri kaynağınız olarak veri feed'lerini kullanmak istiyorsanız yeni veri feed'ini Merchant Center hesabınıza eklemeniz yeterlidir. Ardından, listelenen ürünlerinizin sahipliği feed'e aktarılır. Süreleri dolmadan önce kaldırmak istediğiniz ve yalnızca API'den yüklenen ürünler varsa bunları Merchant Center veya API üzerinden silmeniz gerekir.
Content API for Shopping'i kullanarak ürünlerle birden fazla ülkeyi nasıl hedefleyebilirim?
Content API aracılığıyla gönderilen ürünlere ait reklamlar ve ücretsiz listelemeler ile birden fazla ülkeyi hedeflemek için Merchant Center'daki Content API birincil feed'inde ek ülkeler yapılandırın veya bu ek ülkeleri products kaynağındaki shipping alanı aracılığıyla 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ı ve ücretsiz listelemeleri hedefleme başlıklı makaleyi inceleyin.
İstemci kitaplıklarınızın güncel olduğundan emin olun
Content API ile etkileşime geçmek için bir Google istemci kitaplığı kullanıyorsanız seçtiğiniz programlama dilinin 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 bölümünde, seçtiğiniz dile ait geliştirici kılavuzunu inceleyin.
Farklı alışveriş programlarında hangi ürünlerin gösterileceğini kontrol etmek için hedef özelliklerini kullandığınızdan emin olun.
Content API, Content API feed'inizin Merchant Center'da yapılandırıldığı şekilde varsayılan ayarlarını otomatik olarak benimser. Program katılımını bir feed'de ürün düzeyinde veya Content API aracılığıyla kontrol etmek için includedDestinations veya excludedDestinations ürün özelliklerini kullanabilirsiniz.
API feed'iniz bir programa (ör. 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 yazılır ve söz konusu öğe Google ile Satın Al'da (eski adıyla Shopping Actions) gösterilmez. Buna karşılık, feed'iniz bir programa (ör. Alışveriş) dahil edilmediyse includedDestinations özelliğini ve Shopping_ads değerini kullanarak öğeleri tek tek ekleyebilirsiniz. Bu durumda öğ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 geçerlilik süreleri dolmadan önce güncellemeyi unutmayın
Bir öğe, geçerlilik süresi dolmadan önce değiştirilmezse son güncellemeden 30 gün sonra veya daha önce belirtilen geçerlilik bitiş tarihinde devre dışı bırakılmasını önlemek için öğeyi güncelleyin. Hiçbiri değişmediği veya en son ne zaman güncellendiklerini takip edemediğiniz için çok sayıda öğeyi güncellemeniz gerekiyorsa tüm öğeleri aynı anda güncellemeyin. Bunun yerine, yükü birden fazla güne eşit şekilde dağıtın.
Content API feed'ini silmeyin, aksi takdirde ürünleriniz kaybolabilir
Content API üzerinden channel:online içeren bir ürünü ilk kez yüklediğinizde Merchant Center'da Content API başlıklı yeni bir feed görünür. Content API üzerinden channel:local ile bir ürünü ilk kez yüklediğinizde Merchant Center'da Content API başlıklı ve Yerel Ürünler alt başlıklı yeni bir feed görünür. 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 birçok sıralı veya paralel istek göndermek yerine, istenen tüm istekleri içeren tek bir özel toplu istek gönderin. Bu sayede, API uç noktasına istek gönderme gecikmesi her istek için değil, yalnızca custombatch çağrısı için bir kez gerçekleşir. Bu, özellikle sıralı istekler gönderiyorsanız önemlidir.
Tek bir öğeye tek bir grupta birden fazla güncelleme göndermeyin
Bu, güncelleme sırası konusunda belirsizlik olması nedeniyle beklenmedik sonuçlar verir ve çakışma hatasına neden olabilir.
Değişmeyen öğeler için güncelleme gönderilmez.
Öğelerin süresi aksi takdirde dolmayacaksa yalnızca yeni, değiştirilmiş veya silinmiş ürün öğeleriyle ilgili istek gönderdiğinizden emin olun.
Fiyatlar ve/veya stok durumu hızla değişiyorsa ek feed'leri kullanma
Bir ürünün fiyatını, stok durumunu veya indirim bilgilerini güncel tutma konusunda sorun yaşıyorsanız yalnızca bu özelliklerle ilgili güncelleme göndermek için products kaynağındaki ek feed'leri kullanabilirsiniz. Ek feed güncellemeleri küçük olduğundan, belirli bir dönemde tam ürün güncellemelerinden çok daha fazla ek feed güncellemesi yapabilirsiniz. Bu da ürünlerinizin fiyatlarını ve stok durumunu açılış sayfalarınızla uyumlu tutmanıza yardımcı olur.
Ürün fiyatını ve stok durumunu güncellemenin bir diğer yolu da otomatik öğe güncellemelerini kullanmaktır. Bu özellik, Merchant Center'daki bilgiler ile ürün açılış sayfalarındaki bilgiler arasında uyuşmazlıklar yaşanmasını önlemek için API güncellemelerine ek olarak kullanılabilir. Ancak bu özelliğin, ürün fiyatıyla ve stok durumu doğruluğuyla ilgili küçük sorunları düzeltmek için tasarlandığını unutmayın. Bu nedenle, otomatik öğe güncellemeleri, API aracılığıyla doğru bilgileri sağlamanın yerini almaz.
Yenileme jetonu ne zaman kullanılır?
Yenileme jetonu, yetkilendirme isteklerinin HTTP başlığında döndürülür. Bu paket, kimlik doğrulamayla ilgili birçok bilgi içerir ancak erişim jetonlarının geçerlilik süresi yalnızca 60 dakika olduğu için geliştiricilerin genellikle bu paketten yararlanmak istediği öğe yenileme jetonudur. Bu jeton, kullanıcıdan tekrar tekrar kimlik doğrulaması isteğinde bulunma ihtiyacını ortadan kaldırır.