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. Nisan 2021'de ise 2.0 sürümünü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 v2.1'de kullanıma sunulan birkaç önemli değişikliği hesaba katacak şekilde güncellemeniz gerekir. Aşağıdaki bölümleri inceleyin ve uygulamanızı 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'ler veya products.update kullanın. inventory.set ile daha önce güncellenen tüm alanlar dahil olmak üzere (localinventory'ye özel olanlar hariç) tüm değiştirilebilir ürün alanlarında güncelleme yapılabilir. 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 istekte yer alan 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ç dakika gecikme yaşanıyor.

  • Döndürülen offerId artık giriş offerId ile aynı olmayabilir. v2.1, offerId öğesindeki 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 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ı. Ürünün geçerli olup olmadığına bakılmaksızın her ürünün productId artık döndürülüyor.

  • destinationStatuses içindeki intention, approvalStatus ve approvalPending alanları, status ile değiştirildi. 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ş, çok faktörlü kimlik doğrulamanın kullanılmadığı 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.

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

  • billingAddress ve predefinedBillingAddress artık sırasıyla orders ve TestOrder içinde ü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öntemleriorders.returnlineitem ve orders.refund yerine orderreturns.creatOrderReturn ve orderreturns.process kullanılıyor.

    orderreturns hizmetini kullanmanızı öneririz.

  • 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 verildiği yere bağlı olarak vergi öncesi veya vergi sonrası olabilir.

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

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

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çtikten 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 bildirmeyecek. 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.

    • Şu ö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.