Content API v2'den v2.1'e geçiş

Mart 2019'da Content API for Shopping'in 2.1 sürümünü yayınladık ve Nisan 2021'de 2. sürüm 2'nin 30 Eylül 2021'de kullanımdan kaldırılacağını duyurmuştuk. v2 sürümü kullanımdan kaldırıldı. Lütfen hemen 2.1 sürümüne geçin.

Uygulamanızı taşıyın

v2'den v2.1'e taşıma işlemi, uç nokta URL'lerinizin yeni v2.1 sürümlerini çağıracak şekilde güncellenmesini ve uygulamalarınızı 2.1'de kullanıma sunulan zarar veren değişiklikleri hesaba katacak şekilde değiştirmeyi içerir.

API çağrılarınızı v2.1 uç noktalarını kullanacak şekilde güncelleme

2.1 sürümüne çağrı yapmak için isteklerinizi yeni v2.1 uç noktalarını kullanacak şekilde güncelleyin.

Örneğin, products.get yöntemini v2 ile çağırmak için şunu kullanırsınız:

GET https://shoppingcontent.googleapis.com/content/v2/merchantId/products/productId

Sürüm 2.1 için URL'yi şu şekilde güncelleyin:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId

v2.1 hizmetleri ve uç noktaları hakkında ayrıntılı bilgi için API Referansı'nı inceleyin.

Gerekli değişiklikleri yapın

API çağrılarınızın URL'lerini güncellemenin yanı sıra uygulamanızı, 2.1 sürümünde ortaya çıkan bazı zarar veren değişiklikleri hesaba katacak şekilde güncellemeniz gerekir. Aşağıdaki bölümleri inceleyin ve gerekirse başvurunuzu güncelleyin.

1. inventory hizmetiyle entegrasyonları güncelleme

inventory v2 hizmeti kaldırılmıştır ve aşağıdaki v2.1 özellikleriyle eşdeğer işlevler mevcuttur:

  • Kısmi ürün güncellemeleri için yeni Ek Feed'ler veya products.update kullanın. Daha önce inventory.set ile güncellenmiş tüm alanlar (localinventory ile sınırlı olanlar hariç) dahil olmak üzere, değişebilir tüm ürün alanlarında güncelleme yapılabilir. Daha fazla bilgi için Ek feed'lere geçiş bölümüne bakın.

  • Yerel ürün güncellemeleri için yeni localinventory hizmetini kullanın.

2. accounts hizmetine yapılan çağrıları güncelleme

  • 2.1 sürümünde accounts.update yöntemine yapılan çağrılar, yalnızca isteğe dahil edilen alanları güncellemek yerine accounts kaynağının tamamen üzerine yazılır. accounts kaynağındaki alanları silmemek için çağrı isteklerinizi tüm alanları içerecek şekilde güncelleyin.

  • reviewsUrl kaldırıldı.

  • adsLinks, googleMyBusinessLink ve youtubeChannelLinks için inactive bağlantı durumu kaldırıldı.

3. products hizmetine yapılan çağrıları güncelleme

  • Özel özellikler artık tür ve birim içermemektedir. Bunun yerine, değere birimler eklenmelidir ve türler otomatik olarak algılanmalıdır.

  • Yinelenen productTypes alanı hem productType hem de additionalProductTypes ile değiştirildi.

  • Yinelenen includedDestinations ve excludedDestinations alanları, tekrarlanan destinations alanının yerini aldı.

  • AdWords ile ilgili aşağıdaki alanlar yeniden adlandırıldı:

    • adwordsGrouping -> adsGrouping
    • adwordsLabels -> adsLabels
    • adwordsRedirect -> adsRedirect

  • Aşağıdaki alanlar kaldırıldı:

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

  • includeInvalidInsertedItems parametresi kaldırıldı. Sürüm 2.1'de tüm ürünler varsayılan olarak iade edilir.

  • Artık eklenen bir ürünün products.get veya products.list aracılığıyla alınması birkaç dakika gecikir.

  • Döndürülen offerId öğesinin artık offerId girişiyle aynı olacağı garanti edilmez. 2.1 sürümü, offerId içinde baştaki ve sondaki boşlukları kırpar ve birden fazla boşluk karakterini tek bir karakterde birleştirir. Bu değişiklik, önerilen offerId söz dizimine uygun offerId değerlerini etkilemez.

  • Fiyatlar, artık ürün eklemeden önce doğrulanıyor. Değer dizesinde yalnızca şu karakterlere izin verilir: +, -, . ve rakamlar (ör. 0-9). Virgül artık kabul edilmemektedir.

  • products.insert veya products.update çağrısından gelen yanıtlar yalnızca aşağıdaki özellikleri içerir:

    • channel
    • contentLanguage
    • id
    • offerId
    • feedLabel

  • includeAttributes v2 seçeneğinin desteği sonlandırıldı. Bunun yerine, tüm ürün bilgilerini görüntülemek için ProductId ile birlikte products.get kullanın.

4. productstatuses hizmetine yapılan çağrıları güncelleme

  • includeAttributes parametresiyle birlikte product özelliği kaldırıldı. Ürünün bir duruma karşılık gelen özelliklerini almak için products hizmetini kullanın ve yeni productId alanının değerini iletin.

  • includeInvalidInsertedItems parametresi kaldırıldı. Artık ürünün geçerli olup olmadığına bakılmaksızın her ürünün productId değeri iade edilir.

  • destinationStatuses içindeki intention, approvalStatus ve approvalPending alanları status ile değiştirildi. status değerleri approved, disapproved veya pending değerlerinden biri olabilir.

  • dataQualityIssues, itemLevelIssues ile değiştirildi.

5. datafeeds hizmetine yapılan çağrıları güncelleme

  • Aşağıdaki hedef alanları değiştirildi:

    • contentLanguage -> language
    • targetCountry -> country
    • intendedDestinations -> includedDestinations ve excludedDestinations

  • contentType = "product inventory update" içeren veri feed'leri kaldırıldı.

6. orders ve TestOrders hizmetlerine yapılan çağrıları güncelle

  • 2.1 sürümünde vergi verileri otomatik olarak hesaplandığından, yapılan aramalar vergi verilerini içermez. Sipariş, Pazar Yeri Adalet Yasası (MFA) veya benzeri bir eyalette karşılanırsa vergi verilerini içeren çağrılar başarısız olur. Sipariş, MFA olmayan bir eyalette karşılanırsa vergi, Merchant Center'da yapılandırılan ayarlara göre hesaplanır. Yapılandırılmazsa hesaplanan vergi 0 olur.

  • InStoreRefundLineItem ve ReturnRefundLineItem alanları amountPretax ve amountTax sırasıyla priceAmount ve taxAmount ile değiştirildi. priceAmount, siparişin konumuna bağlı olarak vergi öncesi veya vergi sonrası olabilir.

  • İstekteki ShipLineItem alanları carrier, shipmentId ve trackingId shipmentInfos alanına taşındı.

  • billingAddress ve predefinedBillingAddress artık sırasıyla orders ve TestOrder alanlarında üst düzey alanlardır.

  • customer.explicitMarketingPreference, customer.marketingRightsInfo ile değiştirildi.

  • netAmount alanı netPriceAmount ve netTaxAmount olarak ayrıldı.

  • shippingOption, lineItems[].shippingDetails ile değiştirildi.

  • İstekteki CancelLineItem amount, amountPretax ve amountTax alanları kaldırıldı. Geri ödenen tutar artık otomatik olarak hesaplanıyor.

  • CustomBatch kaldırıldı.

  • Refund kaldırıldı. Bunun yerine refundOrder veya refundItem kullanın.

  • paymentMethod alanı kaldırıldı.

  • v2 yöntemleriorders.returnlineitem ve orders.refund, orderreturns.creatOrderReturn ve orderreturns.process ile değiştirilir.

  • customer.email, channelType ve lineItem.product.channel alanları kaldırıldı.

  • promotions alanı TestOrder hizmetinden kaldırıldı ve Order'da biçimi değiştirildi.

7. orderinvoice hizmetine yapılan çağrıları güncelleme

  • amountPretax ve amountTax alanları sırasıyla priceAmount ve taxAmount ile değiştirildi. priceAmount alanı, siparişin konumuna bağlı olarak vergi öncesi veya vergi sonrası olabilir.

  • invoiceSummary alanındaki bakiyeler (satıcı, müşteri, Google) ve promosyon ücretiyle ilgili alanlardaki kaldırıldı.

8. 2.1 sürümünde bulunmayan kaldırma işlevleri

2.1 sürümünde Content API'den bazı özellikler kaldırıldı. Aşağıdaki listeyi inceleyin ve uygulamanızı gerektiği şekilde güncelleyin:

  • XML artık desteklenmiyor. JSON'a geçiş hakkında daha fazla bilgi için Content API for Shopping'de XML desteğinin kullanımdan kaldırılması konulu makaleyi inceleyin.

  • dryRun parametresi kaldırıldı. Bu değişiklik tüm API çağrıları için geçerlidir.

  • HTTP BATCH yöntemlerin tümü kaldırıldı. Bunun yerine customBatch politikasını kullanın.

  • patch yöntemi şu hizmetlerden kaldırıldı:

    • accounts
    • accounttax
    • datafeeds
    • liasettings
    • shippingsettings

  • orderpayments hizmeti kaldırıldı.

Taşıma işleminizi test etme

2.1 sürümüne geçtikten sonra uygulamalarınızdaki değişiklikleri test etme hakkında daha fazla bilgi için Content API for Shopping'in Kullanımlarını Test Etme başlıklı makaleyi inceleyin. Güncellemelerinizi test ederken sorunlarla karşılaşırsanız sorununuzu Content API forumunda yayınlayabilirsiniz.

2.1 sürümündeki ek değişiklikler

2.1 sürümü, güncelleme gerektiren değişikliklere ek olarak çeşitli yeni özellikler ve kalıcı değişiklikler de sunar:

  • Yeni hizmetler:

    • Yeni localinventory hizmeti, yerel ürün güncellemeleri yapmanızı sağlar (v2'deki inventory hizmetinin yerine).

    • Yeni orderreturns hizmeti, orders hizmetini kullanmak zorunda kalmadan iadeleri işleyebilmenizi sağlayarak Google ile Satın Al'ı (eski adıyla Shopping Actions) yönetmeyi kolaylaştırır.

  • Ek Feed'ler, kısmi ürün güncellemeleri yapmanıza olanak tanır.

  • products hizmetinde ek değişiklikler:

    • products.insert istekleri artık önemli olmayan uyarıları veya hataları bildirmeyecek. Bu işlem, Content API dışında yönetilen feed'lerde olduğu gibi Merchant Center'da feed kuralları aracılığıyla ürün eklemenize ve sorunları çözmek için sonraki güncellemeler yapmanıza olanak tanır.

    • Seçilen ürün alanları grubunda güncelleme yapabilmeniz için products.update eklendi. Olası kullanım hakkında daha fazla bilgi için kılavuza bakın.

    • Aşağıdaki özellikler için geçersiz değerler artık ekleme hatalarını tetiklemez ve productstatus hizmeti tarafından itemLevelIssues kapsamında döndürülür:

      • ageGroup
      • availability
      • condition
      • energyEfficiencyClass
      • gender
      • maxEnergyEfficiencyClass
      • minEnergyEfficiencyClass
      • sizeSystem
      • sizeType

    • Özel özellikler artık yinelemeli olduğundan özel grup ihtiyacını ortadan kaldırır.

    • Özel özellikler artık orijinal value alanının yanı sıra bir groupValues alanına da sahiptir. Alanlardan tam olarak biri ayarlanmalıdır.