Bu dokümanda, en iyi uygulamalarla ilgili yönergeler sunulmaktadır. Daha fazla bilgi için Performans ipuçlarını inceleyin.
API ne zaman kullanılır?
İstekleri programatik olarak göndermek için
İster iş akışınızın her bölümünü otomatik hale getirmeyi ister ERP (Kurumsal Kaynak Planlama) sisteminizde bağlantı oluşturmayı tercih edin, Content API envanteriniz değişir değişmez güncellemeler 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 isteğe anında yanıt alırsınız. Büyük toplu isteklerde beş ila on saniyelik gecikme beklenir.
Ürün verilerinizi sık sık değiştirmek
Content API sayesinde, hızlı değişen ürün envanterinizde bir gün içinde birçok kez artımlı güncellemeler yapabilirsiniz. Ancak her seferinde veri feed'inizin tamamını göndermek mümkün değildir. Güncellemeler ayrı ayrı kullanılabilir hale gelirse bunları ayrı ayrı gönderin. Birden fazla güncelleme olmasını beklemeyin. Benzer şekilde, güncellemeler gruplar halindeyse bunları gruplar halinde gönderin ve bunları tek tek isteklere ayırmayın.
Birkaç alt hesabı yönetmek için:
Yeni oluşturulan Merchant Center hesapları, kendi ürün verilerini tutan tek hesaplardır. Bu ç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ç duyduğunuzu fark edebilirsiniz. Bu durumda, ç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 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ında günlük olarak güncelleme yapmaktan kaçının.
Bunun yerine, yalnızca verileri gerçekten değişmiş ü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ında ürün bilgilerini yönetmekten sorumluysanız products.get veya products.list yöntemleriyle Content API'den düzenli olarak ürün bilgileri istemekten kaçının. Bilgi yükleyen istemciler için bu yöntemler, Content API kullanan çözümler tasarlarken hataları ayıklamanıza yardımcı olabilir. Ancak bu siteler, bu tür müşteriler tarafından ürün bilgilerinin
düzenli olarak alınması 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'leri kullanmadığınızdan emin olun. Her iki aracıda da öğe göndermeye devam ederseniz beklenmedik sonuçlarla karşılaşabilirsiniz.
API ve veri feed'lerini birlikte güvenli bir şekilde birlikte kullanmamın bir yolu var mı?
API'nin Veri Feed'i Hizmeti'ni kullanarak veri feed'lerinizi değiştirebilirsiniz. Bu, veri feed'i yönetimini geniş ölçekte çok daha kolay hale getirecek olsa da beklenmedik sonuçlar ortaya çıkabileceği için API'yi feed'lerle eş zamanlı olarak kullanmamanız veya güncellememeniz gerektiğini unutmayın.
Feed'ler ile API'yi birlikte kullanmanın kabul edilebilir yollarına ilişkin diğer örneklerden bazıları şunlardır:
API'den salt okunur istekler (alma veya listeleme) yürütme: Bazı satıcılar, ürünleriyle ilgili bilgileri ve durum güncellemelerini getirmek için API'yi kullanmak ister. Ürün bilgileri yalnızca feed'ler tarafından güncellendiği için bu kabul edilebilir bir durumdur.
Alt hesaplarınızı (Hesaplar Hizmeti) ve/veya hesap düzeyindeki vergi ve gönderim ayarlarınızı (Hesap Vergi Hizmeti ve Shippingsettings Hizmeti) yönetmek için API'yi kullanma. Bunlar Datafeeds'in sağlayabileceği işlevler değildir. Bu nedenle, bu işlevleri yönetmek için API'nin kullanılmasıyla ilgili herhangi bir çakışma olmaz.
Veri feed'lerinden yalnızca API'ye veya yalnızca API'ye nasıl geçiş yapabilirim?
Şu anda veri feed'leri kullanıyorsanız ve ürünleri güncellemek için yalnızca API'yi kullanmaya geçiş yapmak 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ü veri feed'inden silmek veya veri feed'ini silmek artık ürün bilgilerini Merchant Center hesabınızdan kaldırmaz. Ü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 tekrar sahiplik alır ve ürünün veri feed'inden kaldırılması ürünün kaldırılmasına neden olur.
Ürün bilgileri için şu anda 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 yeni veri feed'i 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 üzere Merchant Center'daki Content API birincil feed'inde ek ülkeler yapılandırın veya bu ülkeleri products kaynağındaki shipping alanından ekleyin.
Content API birincil feed ayarlarını değiştirmeyle ilgili bir örneği aşağıda bulabilirsiniz.
Daha fazla bilgi için Birden çok ülkede Alışveriş reklamlarını ve ücretsiz listelemeleri hedefleme bölümüne bakın.
İstemci kitaplıklarınızın güncel olduğundan emin olun
Content API ile etkileşime geçmek 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 bölümünden seçtiğiniz dile ilişkin geliştirici kılavuzuna bakın.
Farklı alışveriş programlarında hangi ürünlerin gösterileceğini kontrol etmek için varış noktası özelliklerini kullanın
Content API, Content API feed'inizin varsayılan ayarlarını Merchant Center'da yapılandırıldığı şekilde otomatik olarak benimser. Programa katılımı bir feed veya Content API üzerinden ürün düzeyinde kontrol etmek için includedDestinations veya excludedDestinations ürün özelliklerini kullanabilirsiniz.
API feed'iniz bir programa dahil edildiyse (örneğin, Google ile Satın Al (eski adıyla Shopping Actions)) ancak belirli ürünleri hariç tutmak istiyorsanız excludedDestinations özelliğini kullanın ve değer olarak Shopping Actions değerini belirtin. Herhangi bir hata olmaması koşuluyla, bu işlem Merchant Center'daki varsayılan feed ayarlarının üzerine yazar ve söz konusu öğe Google ile Satın Al'da (eski adıyla Shopping Actions) görünmez. Buna karşılık, feed'iniz Alışveriş gibi bir programa dahil edilmemişse includedDestinations ve değer olarak Shopping_ads özelliğini kullanarak öğeleri ayrı ayrı dahil edebilirsiniz. Öğe, Alışveriş reklamlarında gösterilir.
includedDestinations ve excludedDestinations ürün özellikleri hakkında daha fazla bilgi için Yardım Merkezi'ne bakın.
Öğeleri süreleri dolmadan güncellemeyi unutmayın
Bir öğe süresi dolmadan önce değişmezse (son güncellemeden 30 gün sonra veya daha önceyse belirtilen geçerlilik bitiş tarihindeyken) 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 izleyemediğ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 olarak dağıtın.
Content API feed'ini silmeyin. Aksi takdirde ürünleriniz kaybolabilir.
Content API aracılığıyla 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 aracılığıyla 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ığına sahip 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, Merchant Center'a Content API üzerinden eklediğiniz online veya yerel ürünler kaldırılır.
Custombatch yöntemini kullanarak aynı hizmete birden fazla istek gönderin
Aynı hizmete birçok sıralı veya paralel istek yapmak yerine, istenen tüm istekleri içeren tek bir custombatch isteği oluşturun. Bu şekilde, API uç noktasına istek yapma gecikmesi her bir istek yerine, yalnızca bir kez custombatch çağrısı için gerçekleşir. Bu, özellikle sıralı istekler yapıyorsanız önemlidir.
Tek bir gruptaki tek bir öğe için birden fazla güncelleme göndermeyin
Bu, güncellemelerin sırasındaki belirsizlikler nedeniyle beklenmeyen sonuçlara yol açar ve çakışma hatasına neden olabilir.
Değiştirilmeyen öğeler için güncelleme gönderme
Öğelerin kullanım süresi aksi dolmazsa 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ızla değişiyorsa ek feed'leri kullanın.
Bir ürünün fiyat, stok durumu veya indirim bilgilerini güncel tutma konusunda sorun yaşıyorsanız yalnızca bu özelliklere ilişkin güncellemeleri göndermek için products kaynağındaki Ek Feed'ler özelliğini 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 bir diğer yolu da otomatik öğe güncellemelerini kullanmaktır. Bu veriler, 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. Ancak bunun, ü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 üstbilgisinde döndürülür. Kimlik doğrulamayla ilgili daha pek çok bilgi içerir ancak erişim jetonlarının süresi dolmadan önce yalnızca 60 dakika sürdüğünden, yenileme jetonu genellikle kullanıcıdan tekrar tekrar kimlik doğrulaması isteme ihtiyacını ortadan kaldırır. Bu nedenle geliştiricilerin kullanmak istediği unsurdur.