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

Mart 2019'da Content API for Shopping'in 2.1 sürümünü kullanıma sunduk ve Nisan 2021'de 2. sürümün 30 Eylül 2021'de kullanımdan kaldırılacağını duyurduk. v2 sürümünün desteği sonlandırıldı. Lütfen hemen 2.1 sürümüne geçin.

Uygulamanızı taşıma

v2'den v2.1'e geçiş, uç nokta URL'lerinizi yeni v2.1 sürümlerini çağıracak şekilde güncellemenizi ve uygulamalarınızı v2.1'de kullanıma sunulan, uyumluluğu bozan değişiklikleri hesaba katacak şekilde değiştirmenizi gerektirir.

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

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

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

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

v2.1 için URL'yi şu şekilde güncelleyin:

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

2.1 sürümü hizmetleri ve uç noktaları hakkında eksiksiz bilgi için API Referansı'na bakın.

Gerekli değişiklikleri yapın

API çağrılarınızın URL'lerini güncellemenin yanı sıra, uygulamanızı da güncellemeniz gerekir. Bu güncelleme, v2.1'de kullanıma sunulan ve uyumluluğu bozan çeşitli değişiklikleri hesaba katmalıdır. Aşağıdaki bölümleri inceleyin ve başvurunuzu gerektiği şekilde güncelleyin.

1. inventory hizmetiyle entegrasyonları güncelleme

v2 inventory hizmeti kaldırıldı ve eşdeğer işlevler aşağıdaki v2.1 özellikleriyle kullanılabilir:

  • Kısmi ürün güncellemeleri için yeni ek feed'leri veya products.update kullanın. inventory.set ile daha önce güncellenen tüm alanlar dahil olmak üzere tüm değiştirilebilir ürün alanlarında güncelleme yapılabilir (localinventory'ye özel olanlar hariç). Daha fazla bilgi için Ek feed'lere taşıma başlıklı makaleyi inceleyin.

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

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

  • v2.1'deki accounts.update yöntemine yapılan çağrılar, yalnızca isteğe dahil edilen alanları güncellemek yerine accounts kaynağının üzerine tamamen yazar. accounts kaynağındaki alanların silinmesini önlemek için çağrı isteklerinizi tüm alanları içerecek şekilde güncelleyin.

  • reviewsUrl kaldırıldı.

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

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

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

  • Yinelenen productTypes alanı hem productType hem de additionalProductTypes alanının yerini aldı.

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

  • AdWords ile ilgili aşağıdaki alanların adı değiştirildi:

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

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

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

  • includeInvalidInsertedItems parametresi kaldırıldı. v2.1'de tüm ürünler varsayılan olarak döndürülür.

  • Eklenen bir ürünün products.get veya products.list aracılığıyla alınabilmesi için artık birkaç dakikalık bir gecikme söz konusudur.

  • Döndürülen offerId artık giriş offerId ile aynı olmayabilir. v2.1, offerId içindeki baştaki ve sondaki boşlukları kırpar ve birden fazla boşluk karakterini tek bir boşluk karakterinde birleştirir. Bu değişiklik, önerilen offerId söz dizimine uygun offerId değerlerini etkilemez.

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

  • products.insert veya products.update aramalarından gelen yanıtlarda yalnızca aşağıdaki özellikler bulunur:

    • channel
    • contentLanguage
    • id
    • offerId
    • feedLabel

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

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

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

  • includeInvalidInsertedItems parametresi kaldırıldı. Her ürünün productId artık ürünün geçerli olup olmadığına bakılmaksızın döndürülüyor.

  • destinationStatuses içindeki intention, approvalStatus ve approvalPending alanlarının yerini status aldı. status, approved, disapproved veya pending değerlerinden birini alabilen bir dizedir.

  • 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üncelleme

  • Vergi verileri otomatik olarak hesaplandığından v2.1'de çağrılar vergi verilerini içermemelidir. Sipariş, Marketplace Fairness Act (MFA) veya benzeri bir yasanın geçerli olduğu bir eyalette karşılanıyorsa vergi verilerini içeren çağrılar başarısız olur. Sipariş, MFA'nın geçerli olmadığı bir eyalette karşılanıyorsa vergi, Merchant Center'da yapılandırılan ayarlara göre hesaplanır. Yapılandırılmamışsa 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'de üst düzey alanlar.

  • 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 alanları amount, amountPretax ve amountTax 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öntemleri orders.returnlineitem ve orders.refund, orderreturns.creatOrderReturn ve orderreturns.process ile değiştirildi.

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

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

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

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

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

8. v2.1'de bulunmayan işlevleri kaldırma

2.1 sürümünde Content API'den başka özellikler de 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 sonlandırılması başlıklı makaleyi inceleyin.

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

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

  • patch yöntemi aşağıdaki 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çiş yaptıktan sonra uygulamalarınızda yapılan değişiklikleri test etme hakkında daha fazla bilgi için Content API for Shopping Kullanımlarını Test Etme başlıklı makaleyi inceleyin. Güncellemelerinizi test ederken sorun yaşarsanız bize ulaşabilirsiniz.

v2.1'deki ek değişiklikler

Güncelleme gerektiren değişikliklerin yanı sıra v2.1'de birkaç yeni özellik ve uyumluluğu bozmayan değişiklikler de yapıldı:

  • Yeni hizmetler:

    • Yeni localinventory hizmeti, yerel ürün güncellemeleri yapmanıza olanak tanır (v2'deki inventory hizmetinin yerine).

    • Yeni orderreturns hizmeti, orders hizmetini kullanmanıza gerek kalmadan iadeleri işlemenize olanak tanıyarak 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 yapılan ek değişiklikler:

    • products.insert istekleri artık önemli olmayan uyarıları veya hataları bildirmez. Bu sayede, ürün ekleyebilir ve sorunları çözmek için sonraki güncellemeleri Merchant Center'daki feed kuralları üzerinden yapabilirsiniz. Bu, Content API dışında yönetilen feed'lerde olduğu gibidir.

    • products.update simgesi, seçilen bir grup ürün alanında güncelleme yapmanıza olanak tanımak için eklendi. Olası kullanımlarla ilgili daha fazla bilgi için rehbere bakın.

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

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

    • Özel özellikler artık yinelemeli olduğundan özel gruplara gerek kalmıyor.

    • Özel özellikler artık orijinal value alanına ek olarak bir groupValues alanına sahip. Alanlardan tam olarak biri ayarlanmalıdır.