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

Bu sayfada, ürün eklemenize olanak tanıyan veri kaynaklarınızı programatik olarak nasıl oluşturacağınız ve güncelleyeceğiniz gösterilmektedir. Otomatik veri kaynakları, ürün verilerinizin Google'a gönderilmesini kolaylaştırır. 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 izin verir. Merchant Data sources API ile aşağıdaki veri kaynağı türlerini oluşturabilirsiniz:

Content API for Shopping'in yalnızca dosya girişiyle veri kaynaklarının yönetilmesine izin verilir. Merchant API, veri kaynaklarını hem dosya hem de API girişleriyle yönetmenize olanak tanır.

Merchant Data resources API'yi kullanarak aşağıdakileri yapabilirsiniz:

  • Belirli bir feedLabel ve contentLanguage ile yeni bir birincil veri kaynağı oluşturun.
  • Joker karakter veri kaynağı oluşturun. Joker karakter veri kaynağında feedLabel ve contentLanguage alanları ayarlanmamıştır. Joker karakter veri kaynakları, bir veri kaynağına farklı feedLabel ve contentLanguage kombinasyonlarına sahip ürünler eklemenizi sağlar.
  • Mevcut bir birincil veri kaynağına bağlamak için ek veri kaynağı oluşturun.
  • Dosya veri kaynağı için program ayarlayın.
  • API veri kaynaklarını yönetin.
  • Promosyonlar gibi diğer veri kaynağı türlerini kullanın.

Ön koşullar

  • Hesabınız tek yerel feed'lere taşınmış olmalıdır.
  • Hesabın veri hedefi bölmesine zaten taşındığını doğrulamak için veri kaynağı listesini kullanın veya yöntemler alın. Uygun değilseniz aşağıdaki istisna mesajını alırsınız ve destek ekibiyle iletişime geçmeniz 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

Belirli bir feedLabel ve contentLanguage ile yeni bir birincil veri kaynağı oluşturmak için türe özel yapılandırmada feedLabel ve contentLanguage alanlarını ayarlayın. Örneğin, PrimaryProductDataSource.

Yeni oluşturulan veri kaynağınızı görüntülemek için GET veya LIST isteği oluşturun.

Yeni bir joker karakter birincil veri kaynağı oluşturun

Yeni bir joker karakterli 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 oluşturulmuş yalnızca bir API veri kaynağı vardır. Merchant Data resources API'yi kullanarak bazıları joker karakterli olabilen birden çok API veri kaynağınız olabilir.

Yalnızca API girişi olan veri kaynakları joker karakterli veri kaynakları olabilir. Dosya girişleri için joker karakter veri kaynakları desteklenmez.

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

accounts.productInputs.insert ve accounts.productInputs.delete yöntemlerine çağrı yaparken veri kaynağının benzersiz tanımlayıcısını sorgu parametresi olarak ekleyerek ürün verilerinde kısmi güncellemeler yapmak için ek veri kaynaklarından yararlanabilirsiniz. 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 ile yapılandırın ve birincil veri kaynağınızdaki defaultRule alanını güncelleyerek veri kaynağınızı bağlayın.

Ek dosya veri kaynakları joker karakterli veri kaynakları olamaz. Ek API veri kaynakları her zaman joker karakterli veri kaynakları olmalıdır.

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

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

Veri kaynağını silme

Hesabınızdaki mevcut bir veri kaynağını silmek için accounts.dataSources.delete yöntemini kullanın.

Getirme veri kaynağı

Veri kaynağında yapılandırılmış bir dosyayı getirmek için accounts.dataSources.fetch yöntemini kullanın. Bu yöntem, hesabınızdaki bir veri kaynağında hemen veri getirme işlemini gerçekleştirir. Bu yöntem yalnızca bir dosya girişi ayarlanmış veri kaynaklarında kullanılabilir.

Veri kaynağı alın

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

Veri kaynağını listeleyin

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

Veri kaynağına yama uygulayın

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