Veri kaynaklarını taşıma

Bu kılavuzda, entegrasyonunuzu Content API for Shopping'in datafeeds ve datafeedstatuses hizmetlerinden Merchant API'deki veri kaynakları alt API'sine nasıl taşıyacağınız açıklanmaktadır. Yeni veri kaynakları alt API'si, veri ardışık düzenleriniz üzerinde daha doğrudan kontrol sağlar ve veri kaynaklarının yönetimini basitleştirir.

Yeni özellikler hakkında daha fazla bilgi için Veri kaynaklarınızı yönetme kılavuzuna bakın.

Temel farklılıklar

Merchant API, Content API for Shopping'e kıyasla çeşitli avantajlar sunar.

• Veri kaynağının açıkça oluşturulması. API, ilk ürün ekleme işleminde artık otomatik olarak "Content API" veri kaynağı oluşturmaz. Merchant API'de, ürünleri yükleyebilmek için veri kaynaklarını açıkça oluşturursunuz. Bu sayede, ürün verileri işlem hatlarınızın kuruluş ve yönetimi üzerinde en başından itibaren daha fazla kontrol sahibi olursunuz.

• Birden fazla API veri kaynağı için destek. Content API for Shopping'de, otomatik olarak oluşturulan tek bir "Content API" veri kaynağıyla sınırlıydınız. Merchant API ile API giriş türünde birden fazla veri kaynağı oluşturup yönetebilirsiniz.

• Etiket ve dil içermeyen veri kaynakları. Merchant API, feedLabel ve contentLanguage belirtmeden birincil veri kaynağı oluşturmanıza olanak tanır. Bu tür veri kaynağı, feedLabel ve contentLanguage kombinasyonlarının herhangi birinde ürünleri kabul eder. Bu da farklı bölgeler için ayrı veri kaynakları gerektirmeyen entegrasyonlarda ürün yüklemeyi kolaylaştırır.

• Basitleştirilmiş veri hedefleri. Artık her veri kaynağı, feedLabel ve contentLanguage öğelerinin benzersiz bir kombinasyonuyla tanımlanan tek bir hedefe karşılık geliyor. Çok verili hedef feed'ler, Merchant API'de kullanımdan kaldırıldı.

• Dosya yükleme durumu. Merchant API, dosya tabanlı veri kaynaklarının durumunu ayrı bir salt okunur fileUploads kaynağı kullanarak gösterir. Bir dosya yüklemenin durumunu almak için fileUploads.get yöntemini latest takma adıyla kullanın.

• Yeni veri kaynağı türleri. DataSource kaynağı, promosyonlar, yerel envanter ve bölgesel envanter dahil olmak üzere daha fazla sektörü destekleyerek tüm veri işlem hatlarınızı yönetmek için birleşik bir yol sunar.

• Otomatik veri kaynakları Merchant API ile artık Accounts alt API'sindeki autofeedSettings.updateAutofeedSettings yöntemini kullanarak hesabınız için otomatik veri kaynakları özelliğini etkinleştirebilir veya devre dışı bırakabilirsiniz. Daha fazla bilgi için Otomatik besleme ayarlarını yapılandırma başlıklı makaleye bakın.

İstekler

Aşağıdaki tabloda, Content API for Shopping ile Merchant API arasındaki istek URL'si biçimleri karşılaştırılmaktadır.

İstek açıklaması	Content API for Shopping	Merchant API
Veri kaynağı oluşturma	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Veri kaynağı alma	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Veri kaynaklarını listeleme	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Veri kaynağını güncelleme	PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Veri kaynağını silme	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Veri kaynağı getirme	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch
Veri kaynağı durumunu alma	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest
Veri kaynağı durumlarını listeleme	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses	Yok. Dosya tabanlı her veri kaynağı için dataSources.list ve fileUploads.get yöntemlerini kullanın.

Tanımlayıcılar

Merchant API, tanımlayıcı olarak dize tabanlı bir kaynak adı kullanır.

Tanımlayıcı açıklaması	Content API for Shopping	Merchant API
Veri kaynağı tanımlayıcısı	datafeedId (sayısal)	name (dize, biçim: accounts/{account}/dataSources/{datasource})

Yöntemler

Bu tabloda, Content API for Shopping datafeeds ve datafeedstatuses hizmetlerindeki yöntemler, Merchant API'deki eşdeğerleriyle karşılaştırılmaktadır.

Content API for Shopping yöntemi	Merchant API yöntemi	Kullanılabilirlik ve notlar
datafeeds.custombatch	Kullanılamıyor	Bunun yerine ayrı API çağrıları kullanın.
datafeeds.delete	dataSources.delete	Mevcut.
datafeeds.fetchnow	dataSources.fetch	Mevcut. Bu yöntem artık yalnızca dosya girişi olan veri kaynaklarında çalışır.
datafeeds.get	dataSources.get	Mevcut.
datafeeds.insert	dataSources.create	Mevcut.
datafeeds.list	dataSources.list	Mevcut.
datafeeds.update	dataSources.update	Mevcut. PUT yerine PATCH semantiğini kullanır.
datafeedstatuses.custombatch	Kullanılamıyor	Bunun yerine ayrı API çağrıları kullanın. Daha fazla bilgi için Tek seferde birden fazla istek gönderme başlıklı makaleyi inceleyin.
datafeedstatuses.get	fileUploads.get	Dosya tabanlı veri kaynaklarında kullanılabilir. En son yüklemenin durumunu almak için latest takma adını kullanın. Diğer veri kaynağı türlerinde durum bilgileri DataSource kaynağının bir parçasıdır.
datafeedstatuses.list	Kullanılamıyor	Birden fazla veri kaynağının durumunu almak için önce tüm veri kaynaklarını dataSources.list ile listeleyin. Ardından, dosya tabanlı her veri kaynağı için latest takma adıyla fileUploads.get işlevini çağırın.

Ayrıntılı alan değişiklikleri

Bu tabloda, Content API for Shopping'deki Datafeed ve DatafeedStatus kaynakları ile Merchant API'deki DataSource ve FileUpload kaynakları arasındaki alan düzeyinde değişiklikler gösterilmektedir.

Content API for Shopping	Merchant API	Açıklama
Datafeed	DataSource	Veri kaynağı yapılandırmasıyla ilgili ana kaynak.
id	name	Kaynak tanımlayıcısı. Sayısal kimlikten dize kaynak adına değiştirildi.
name	displayName	Veri kaynağının kullanıcıya gösterilen adı.
attributeLanguage	primaryProductDataSource.contentLanguage	Veri kaynağındaki öğelerin iki harfli ISO 639-1 dil kodu.
fileName	fileInput.fileName	Yüklenen dosyanın adı. Bu alan artık fileInput altında yer alıyor.
fetchSchedule	fileInput.fetchSettings	Dosya tabanlı bir veri kaynağının getirilme planı. Bu öğe artık fileInput altında iç içe yerleştirilmiş durumda.
fetchSchedule.paused	fileInput.fetchSettings.enabled	Mantık tersine çevrilir. paused: true, enabled: false ile eş değerdir.
format	Kullanılamıyor	fileEncoding, columnDelimiter ve quotingMode alanları kaldırılır. Bunlar artık otomatik olarak algılanıyor.
targets	primaryProductDataSource.feedLabel, primaryProductDataSource.contentLanguage, primaryProductDataSource.countries	Yinelenen targets alanı kaldırılır. Artık her veri kaynağının bu alanlarla tanımlanan tek bir hedefi var. Bu, çoklu veri hedefli feed'lerin desteğinin sonlandırılmasını yansıtıyor.
DatafeedStatus	FileUpload	Dosya yükleme durumu artık ayrı bir salt okunur kaynak.
datafeedId	name	Dosya yüklemenin tanımlayıcısı, üst veri kaynağına referans verir.
processingStatus	processingState	Yüklemenin işleme durumu. Dize değerleri (success, failure, in progress) bir enum (SUCCEEDED, FAILED, IN_PROGRESS) ile değiştirilir.
errors, warnings	issues	Hatalar ve uyarılar tek bir issues listesinde birleştirilir. Her sorunun severity alanı (ERROR veya WARNING) vardır.
lastUploadDate	uploadTime	Son yüklemenin zaman damgası. Biçim, dizeden Timestamp nesnesine değiştirildi.
country, language, feedLabel	Geçerli değil	Bu alanlar artık durum kaynağında yer almıyor. Bunlar, DataSource kaynağının bir parçasıdır.
targets[].included_destinations, targets[].excluded_destinations	primaryProductDataSource.destinations	Dahil edilen ve hariç tutulan hedeflere yönelik iki ayrı liste, tek bir destinations listesiyle değiştirilir. Yeni listedeki her öğe, hedefi ve durumunu (ENABLED veya DISABLED) belirten bir nesnedir ve daha açık bir yapılandırma sağlar.