Satıcı Veri Kaynakları API'sine genel bakış

Bu sayfada, ürün eklemenize olanak tanıyan veri kaynaklarınızı programlı olarak nasıl oluşturacağınız ve güncelleyeceğiniz gösterilmektedir. Otomatik veriler kaynaklar, gönderilen e-posta Google'a ileteceksiniz. Otomatik veri kaynakları, web sitenizdeki alakalı ürünlerle ilgili en güncel bilgilerin Google'a ulaşmasını sağlar.

Content API for Shopping yalnızca birincil veri kaynakları oluşturmanıza olanak tanır. Satıcı Veri Kaynakları API'si ile aşağıdaki veri kaynağı türlerini oluşturabilirsiniz:

Content API for Shopping, yalnızca dosya girişi olan veri kaynaklarını yönetmenize olanak tanır. Merchant API, veri kaynaklarını hem dosya hem de API girişleriyle yönetmenize olanak tanır.

Satıcı Veri Kaynakları API'yi kullanarak şunları yapabilirsiniz:

  • Belirli bir feedLabel ve contentLanguage.
  • feedLabel ve contentLanguage alanlarının ayarlanmadığı bir veri kaynağı oluşturun. Bu tür bir veri kaynağı kullanarak, tek bir veri kaynağına farklı feedLabel ve contentLanguage kombinasyonlarına sahip ürünler ekleyebileceğiniz için ürünleriniz için birden fazla ülkeyi hedefleyebilirsiniz.
  • Mevcut bir birincil veri kaynağına bağlamak için ek veri kaynağı oluşturun.
  • Dosya veri kaynağı için program ayarlayın.
  • Veri kaynaklarının otomatik olarak yönetilmesi için hesabınızı kaydedin.
  • API veri kaynaklarını yönetin.
  • Birincil ürün veri kaynaklarını kullanan varsayılan veri kaynakları kuralını yönetin.
  • Promosyonlar gibi diğer veri kaynağı türlerini kullanın.

Hem yerel hem de online ürünler içeren bir veri kaynağına ürün eklemek için Merchant API'yi kullanamazsınız. Veri kaynağı kanalları hakkında daha fazla bilgi için Kanallar başlıklı makaleyi inceleyin.

Ön koşullar

  • Hesabınız tek yerel feed'lere taşınmış olmalıdır.

  • Hesabın veri hedefi bölme işlemine taşındığını doğrulamak için veri kaynağı listesini veya get yöntemlerini kullanın. Uygun olmamanız durumunda ve destek ekibiyle bağlantı kurmanız gerekir.

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

Yeni veri kaynağı oluşturma

Birincil veri kaynakları, Merchant Center envanterinizin ana veri kaynaklarıdır. Ürünleri yalnızca birincil veri kaynağı kullanarak ekleyebilir veya kaldırabilirsiniz. Eğer birincil veri kaynağınıza eklediğiniz her ürün Merchant Center'ın verilerini karşılıyor ve uygunluk koşullarını karşılıyorsanız başka veri kaynağı oluşturmanız gerekmez.

Belirli bir feedLabel ve contentLanguage için feedLabel ve contentLanguage alanlarını özgüdür. Bu alanlar hakkında daha fazla bilgi için PrimaryProductDataSource bölümüne bakın.

Veri kaynağı oluşturma hakkında daha fazla bilgi için accounts.dataSources.create yöntemidir.

Yeni oluşturulan veri kaynağınızı görüntülemek için accounts.dataSources.get veya accounts.dataSources.list yöntemidir.

Birden fazla ülkeyi hedeflemeye yardımcı olan yeni bir birincil veri kaynağı oluşturun

Birden fazla ülkeyi hedeflemenize yardımcı olacak yeni bir birincil feed oluşturmak için PrimaryProductDataSource kullanarak veri kaynağınızı yapılandırın ve feedLabel ile contentLanguage alanlarını ayarlamayın.

Content API for Shopping'i kullandığınızda sizin için yalnızca bir API veri kaynağı oluşturulur. Merchant Data Sources API'yi kullanarak birden fazla API veri kaynağı oluşturabilirsiniz. Bunlardan bazıları feedLabel ve contentLanguage alanları ayarlanmamış olabilir.

Yalnızca API girişi olan veri kaynakları feedLabel ve contentLanguage alanları ayarlandı. Bu tür veri kaynakları, dosya girişlerinde desteklenmez.

Ek veri kaynağı oluşturma ve bu kaynağı birincil veri kaynağına bağlama

Ek veri kaynakları yalnızca halihazırda bir veya daha fazla birincil veri kaynağında bulunması gerekir. Birden fazla ek veri kaynakları ve her biri istenilen sayıda birincil veriye veri sağlayabilir kaynaklar.

Aşağıdakileri yaparak ürün verilerinde kısmi güncellemeler yapmak için ek veri kaynaklarından yararlanabilirsiniz: oluştururken veri kaynağının benzersiz tanımlayıcısını sorgu parametresi olarak accounts.productInputs.insert ve accounts.productInputs.delete yöntemlerine göz atın. Ek veri kaynaklarını yalnızca mevcut ürünleri güncellemek için kullanabilirsiniz.

Ek veri kaynağı oluşturmak için veri kaynağınızı SupplementalProductDataSource kullanarak yapılandırın ve ardından birincil veri kaynağınızdaki defaultRule alanını güncelleyerek bağlayın.

Ek dosya veri kaynaklarında feedLabel ve contentLanguage bulunmalıdır alanları ayarlandı. Ek API veri kaynaklarında her zaman feedLabel ve contentLanguage alan ayarlanmadı.

Dosya veri kaynağınız için plan oluşturma

Dosya feed'iniz için bir plan oluşturmak üzere veri kaynağınızı dosya olacak şekilde yapılandırın FileInput alanını kullanarak veri kaynağı oluşturun ve ardından fetchsettings (FileInput.FetchSettings alanı kullanılır).

Veri kaynağını silme

Mevcut bir veri kaynağını hesabınızdan silmek için accounts.dataSources.delete yöntemidir.

Getirme veri kaynağı

Veri kaynağında yapılandırılmış bir dosyayı almak için accounts.dataSources.fetch yöntemini kullanın. Bu yöntem, ve oturum açın. Bu yöntem yalnızca dosya girişi ayarlanmış veri kaynaklarında çalışır.

Veri kaynağı alma

Hesabınızın veri kaynağı yapılandırmasını almak için accounts.dataSources.get yöntemidir.

Veri kaynağını listeleme

Hesabınızın veri kaynaklarının yapılandırmalarını listelemek için accounts.dataSources.list yöntemini kullanın.

Veri kaynağına yama uygulama

Mevcut bir veri kaynağının yapılandırmasını güncellemek için accounts.dataSources.patch yöntemini kullanın.

Birincil ürün veri kaynakları, veri kaynaklarının varsayılan kuralını yönetmenize olanak tanır. Varsayılan kural, bu sertifikanın tamamı için geçerli olan özellikleri hakkında daha fazla bilgi edinin. Varsayılan kural, veri kaynağı oluşturulurken veya varsayılan kural alanı aracılığıyla mevcut bir veri kaynağı güncellenerek ayarlanabilir.

Aşağıdaki örnek yapılandırma, tüm özelliklerin önce 1001 benzersiz tanımlayıcısıyla veri kaynağından alınmasını sağlar. Ardından, eksik özellikler birincil veri kaynağından eklenir. Sonuç olarak, özellikleri, benzersiz Başka bir veri kaynağında henüz sağlanmamışsa 1002 tanımlayıcısını kullanabilirsiniz. Aynı özellik birden fazla veri kaynağında sağlanırsa listede daha üst sıradaki değer seçilir.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Feed'lerin otomatik yönetimi

Hesabınızı, veri kaynaklarının otomatik yönetimi için kaydettirmek üzere takip etmek için:

Hesabınız kayıt için uygun hale geldikten sonra, veri kaynaklarının otomatik yönetimini etkinleştirmek için accounts.autofeedSettings.updateAutofeedSettings yöntemini kullanabilirsiniz. Veri kaynaklarının otomatik yönetimini etkinleştirmek, Google'ın online mağazanızdaki ürünlerinizi otomatik olarak eklemesine ve Google platformlarında her zaman güncel olmasını sağlamaya olanak tanır.

Dosya yükleme durumunu alma

Dosya, getirme veya e-tablo kullanarak bir veri kaynağının durumunu öğrenmek için şunun GET yöntemini çağırabilir: accounts.dataSources.fileUploads geliştirmenizi sağlar. Hesaplanan veri kaynağının son alımının sonucunu elde etmek için eşzamansız olarak işlemeyi tamamlamak için veri kaynağının işlenmesi tamamlandığında tanımlayıcı latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

Dosya yükleme durumu, aşağıdakiler dahil olmak üzere ürünlerinizin ayrıntılı bir görünümünü içerebilir. ortadan kaldırabilirsiniz.

Dosya hiç yüklenmemişse dosya yükleme durumunun mevcut olmayabileceğini unutmayın. Dosya yükleme durumu, bu süreden kısa bir süre sonra istenirse işlenme durumunda olabilir emin olun.