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 veri kaynakları, ürün verilerinizi Google'a göndermeyi 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 olanak tanır. Satıcı Veri Kaynakları API ile aşağıdaki veri kaynağı türlerini oluşturabilirsiniz:

• Birincil ürün veri kaynakları
• Ek ürün veri kaynakları
• Yerel envanter veri kaynakları
• Bölgesel envanter veri kaynakları
• Promosyon veri kaynakları
• Ürün yorumu veri kaynakları
• Satıcı yorumu veri kaynakları

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.

Merchant Center Veri Kaynakları API'yi kullanarak şunları yapabilirsiniz:

• Belirli bir feedLabel ve contentLanguage ile yeni bir birincil veri kaynağı oluşturun.
• feedLabel ve contentLanguage alanlarının ayarlanmadığı bir veri kaynağı oluşturun. Bu tür bir veri kaynağı kullanarak, feedLabel ve contentLanguage'nin farklı kombinasyonlarını içeren ürünleri tek bir veri kaynağına 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 bir plan oluşturun.
• Hesabınızı veri kaynaklarının otomatik olarak yönetilmesi için kaydedin.
• API veri kaynaklarını yönetin.
• Birincil ürün veri kaynaklarını kullanarak veri kaynaklarının varsayılan 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 ayar feed'lerine 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 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

Birincil veri kaynakları, Merchant Center envanterinizin ana veri kaynaklarıdır. Yalnızca birincil veri kaynağı kullanarak ürün ekleyebilir veya kaldırabilirsiniz. Birincil veri kaynağınıza eklediğiniz her ürün Merchant Center'ın veri ve uygunluk şartlarını karşılıyorsa başka veri kaynağı oluşturmanız gerekmez.

Belirli bir feedLabel ve contentLanguage ile yeni bir birincil veri kaynağı oluşturmak için feedLabel ve contentLanguage alanlarını türe özgü yapılandırmada ayarlayın. Bu alanlar hakkında daha fazla bilgi için PrimaryProductDataSource bölümüne bakın.

Aşağıdaki örnek istek, birincil ürün veri kaynağını nasıl oluşturabileceğinizi gösterir:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Aşağıdakini değiştirin:

• {ACCOUNT_ID}: Merchant Center hesabınızın benzersiz tanımlayıcısı.
• {DISPLAY_NAME}: Veri kaynağının görünen adı.
• {CONTENT_LANGUAGE}: Veri kaynağındaki ürünlerin iki harfli ISO 639-1 dil kodu.
• {FEED_LABEL}: Veri kaynağının feed etiketi.
• {COUNTRY}: Veri kaynağı kullanılarak yüklenecek ürünlerin hedef ülkesinin CLDR bölge kodu.

İstek başarıyla çalıştırıldıktan sonra aşağıdaki yanıtı görürsünüz:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

Yeni oluşturduğunuz veri kaynağını görüntülemek için accounts.dataSources.get veya accounts.dataSources.list yöntemini kullanın.

Birden fazla ülkeyi hedeflemenize yardımcı olacak yeni bir birincil veri kaynağı oluşturma

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ında feedLabel ve contentLanguage alanları ayarlanmamış olabilir. Bu tür veri kaynakları, dosya girişleri için desteklenmez.

Ek veri kaynağı oluşturun ve birincil veri kaynağına bağlayın

Ek veri kaynakları yalnızca bir veya daha fazla birincil veri kaynağında zaten bulunan ürün verilerini güncellemek için kullanılır. Birden fazla ek veri kaynağınız olabilir ve her biri, istenilen sayıda birincil veri kaynağına veri sağlayabilir.

accounts.productInputs.insert ve accounts.productInputs.delete yöntemlerini çağırırken 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ını kullanabilirsiniz. Ek veri kaynaklarını yalnızca mevcut ürünleri güncellemek için kullanabilirsiniz.

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

Ek dosya veri kaynaklarında feedLabel ve contentLanguage alanları ayarlanmalıdır. Ek API veri kaynaklarında feedLabel ve contentLanguage alanlarının değeri her zaman ayarlanmamış olmalıdır.

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

Dosya feed'iniz için bir program oluşturmak istiyorsanız veri kaynağınızı FileInput alanını kullanarak dosya veri kaynağı olarak 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.

Veri kaynağını getirme

Veri kaynağında yapılandırılmış bir dosyayı almak için accounts.dataSources.fetch yöntemini kullanın. Bu yöntem, hesabınızdaki bir veri kaynağında veri getirme işlemini hemen gerçekleştirir. 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öntemini kullanın.

Veri kaynağını listeleme

Hesabınızdaki 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.

Veri kaynaklarını bağlama

Birincil ürün veri kaynakları, veri kaynaklarının varsayılan kuralını yönetmenize olanak tanır. Varsayılan kural, veri kaynağınızdaki tüm özellikler için geçerli olan kuraldır. Varsayılan kural, veri kaynağı oluşturulurken veya varsayılan kural alanı aracılığıyla mevcut bir veri kaynağı güncellenerek ayarlanabilir.

Kural oluşturma hakkında daha fazla bilgi için Ürün veri kaynaklarınız için kurallar oluşturma başlıklı makaleyi inceleyin.

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. Diğer veri kaynaklarında sağlanmamışsa kalan özellikler, 1002 benzersiz tanımlayıcısıyla ek veri kaynağından alınır. 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
 ]
}

Not: Özel kurallar API üzerinden değiştirilemez.

Feed'lerin otomatik yönetimi

Hesabınızı veri kaynaklarının otomatik yönetimi için kaydetmek üzere aşağıdakileri yapmanız gerekir:

• accounts.autofeedSettings.getAutofeedSettings yöntemini çağırarak hesabınızın kayıt için uygun olup olmadığını kontrol edin.
• Hesabınızın pazar yeri hesabı olmadığından emin olun.

Hesabınız kayıt için uygun hale geldikten sonra, veri kaynaklarının otomatik olarak yönetilmesini 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 içeren bir veri kaynağının durumunu almak için accounts.dataSources.fileUploads hizmetinin GET yöntemini çağırabilirsiniz. Veri kaynağı işleme işlemi tamamlandığında veri kaynağının son getirilmesinin sonucunu asynkron olarak hesaplamak için ad tanımlayıcısı latest'ü kullanın.

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

Dosya yükleme durumu, olası sorunlar da dahil olmak üzere ürünlerinizin ayrıntılı bir görünümünü içerebilir.

Dosya hiç yüklenmemişse dosya yükleme durumunun mevcut olmayabileceğini unutmayın. Dosya yükleme işlemi, dosya yüklendikten kısa bir süre sonra istenirse işleme durumunda olabilir.