Sürüm Notları (v2.1)

15 Kasım 2024

Ürün Servisi

LoyaltyProgram için uygunluğu belirtmek üzere shipping_label alanını ekledim. Alanda bir değer varsa bu teklifte bağlılık kapsamında kargo avantajı vardır. Alan değeri sağlanmazsa öğe, belirli bir bağlılık katmanı için bağlılık kapsamındaki gönderim için uygun değildir.

30 Ekim 2024

Ödemeyle ilgili API'lerin kullanımdan kaldırılması kapsamında aşağıdaki hizmetlerin desteği sonlandırılıyor: - settlementreports - settlementtranscations

Settlement ile ilgili API'lerin kullanımdan kaldırılması, daha önce kullanımdan kaldırılan Google ile Satın Al programı ve Siparişler ile ilgili API'lerle ilgilidir.

Yukarıda belirtilen hizmetlere yapılan çağrıların Service was not found on the server yanıtıyla başarısız olması beklenir.

16 Ekim 2024

UpdateConversionSourceRequest'daki update_mask artık OPTIONAL. Güncelleme maskesi belirtilmezse boş olmayan tüm alanlar güncellenir.

26 Ağustos 2024 (ilk olarak bildirilenden daha erken)

Siparişlerle ilgili API'lerin kullanımdan kaldırılması kapsamında aşağıdaki hizmetlerin desteği sonlandırıldı: - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

Yukarıda belirtilen hizmetlere yapılan çağrıların Service was not found on the server yanıtıyla başarısız olması beklenir.

OrderTrackingSignals hizmeti kullanımdan kaldırılmadı ve kullanılabilir durumda olmaya devam ediyor.

10 Ağustos 2024

Google ile Satın Al hizmetleri

Google ile Satın Al API'lerinin kullanımdan kaldırılması kapsamında, BuyOnGoogleProgramService içindeki tüm yöntemler service was not found on the server ile başarısız olur.

19 Temmuz 2024

Ürün Servisi

member_price_effective_date alanı eklendi. Bu güncelleme, varsa bağlılık programı üyesi fiyatının geçerli olduğu tarih aralığını belirtmenize olanak tanır. Alan değeri sağlanmazsa üyelere özel fiyat her zaman geçerli olur.

20 Mayıs 2024

Ürün Servisi

LoyaltyPrograms eklendi. Bu güncelleme, tek bir ürün için farklı bağlılık puanları, fiyatlar vb. içeren birden fazla katman sunmanıza olanak tanır. Tekil LoyaltyProgram alanı yerine bu alanı kullanmalısınız.

Raporlar Hizmeti

MerchantPerformanceView tablosundaki desteği sonlandırılan Google ile Satın Al metrikleri. Bu güncellemeden sonra, Google ile Satın Al metrikleri 0 değerini döndürür. Bu durum, geçmiş tarihlere ait geçmiş değerler için de geçerlidir.

Daha fazla bilgi için Google ile Satın Al'ın kullanımdan kaldırılması başlıklı makaleyi inceleyin.

13 Mayıs 2024

Ürün Servisi

Ürün Kaynağı

Sertifikalar alanında yapılan değişiklikler: Sertifika değerini (sınıf, düzey veya not olarak da bilinir) sağlamak için ProductCertification alanına certificationValue eklendi. Bu, sertifika yetkilisi sertifika kodu veya numarası vermese bile kullanıcıların sertifika bilgilerini yüklemesine olanak tanır.

Daha fazla bilgi için ürün kılavuzlarımızı inceleyin.

6 Mayıs 2024

Raporlar Hizmeti

PriceInsightsProductView tablosuna verimlilik grubu eklendi. Etki düzeyi, fiyat değişikliklerinden en çok fayda sağlayacak ürünleri gösterir. Bu derecelendirmede, indirimli fiyatın ayarlanmasıyla tahmin edilen performans artışı ve geçerli fiyatınız ile önerilen fiyat arasındaki fark göz önünde bulundurulur.

24 Nisan 2024

Ürün Servisi

Ürün Kaynağı

Taksitli ödemeler için isteğe bağlı downpayment ve creditType alanları eklendi:

  • downpayment, alıcının tek seferlik ödeme olarak peşin ödemesi gereken tutarı sağlar.
  • creditType, taksit ödemesinin türünü (finance veya lease) belirtir. Bu alan yalnızca araç reklamları için geçerlidir.

11 Nisan 2024

Ürün Servisi

Ürün Kaynağı

  • Teklif düzeyinde kargo için ücretsiz kargo eşiği özelliği (FreeShippingThreshold) eklendi. Bu özellik, satıcıların gönderim maliyetinin ücretsiz olması için minimum bir ürün fiyatı girmelerine olanak tanır.
  • LoyaltyPoints öğesinin görünürlüğü değiştirildi

10 Nisan 2024

Ürün Servisi

Ürün Kaynağı

LoyaltyProgram eklendi

9 Nisan 2024

Ürün Servisi

Ürün Kaynağı

Yapay zeka tarafından üretilen ürün başlıkları ve açıklamaları sağlamak için structuredTitle ve structuredDescription eklendi.

3 Nisan 2024

Satıcı Destek Hizmeti

İş ortaklarının yeni bir işlem türü istemesine olanak tanıyan user_input_action_option alanı eklendi: BuiltInUserInputAction. Bu işlem, iş ortaklarının satıcıları Merchant Center'a yönlendirmek yerine doğrudan kendi uygulamalarında karmaşık self servis işlevler oluşturmasına olanak tanır.

BuiltInUserInputAction için yeni bir TriggerAction yöntemi eklendi. Bu yönteme erişmek için bu formu kullanarak istek gönderin.

27 Mart 2024

Ürün Servisi

Ürün Kaynağı

"Otomatik İndirimler" ve "Dinamik Promosyonlar" projelerinde bir önlem olarak AutoPricingMinPrice eklendi. Bu sayede, satıcıların tekliflerindeki indirimler ürün fiyatını bu değerin altına düşürmez. Böylece teklifin değerini ve kârlılığını koruyabilirsiniz.

15 Mart 2024

Arama ve Alışveriş için Google ile Satın Al özelliği kullanımdan kaldırılıyor. Mevcut siparişleri orders.list ve orders.get'i kullanarak 31 Ekim 2024'e kadar görüntülemeye devam edebilirsiniz.

8 Mart 2024

Raporlar Hizmeti

Reports hizmetine TopicTrendsView raporu eklendi.

Daha fazla bilgi için raporlama kılavuzlarımızı inceleyin.

6 Mart 2024

Raporlar hizmeti

Ürünler için tıklama potansiyeli grubu ve sıralaması eklendi.

Daha fazla bilgi için raporlama kılavuzlarımızı inceleyin.

19 Şubat 2024

ConversionSources Hizmeti

Aşağıdaki değerler geçerli dönüşüm kaynakları olarak kaldırıldı:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Yeniden inceleme aralığı olarak 60 ve 90 günlük seçenekler kaldırıldı ve geçerli bir seçenek olarak 40 eklendi.

17 Ocak 2024

POS hizmeti

PosStore alanındaki matching_status_hint alanı için yeni değerler eklendi. Bu sayede kullanıcılar, mağaza eşleştirmelerinin neden başarısız olduğu hakkında daha fazla bilgi edinebilir.

11 Ocak 2024

Hesap hizmeti

link yöntemi için sırasıyla bağlantı türü ve hizmet olarak localProductManager ve localProductManagement eklendi. Bu bağlantılar, yerel ürün verilerini yönetmek amacıyla hesapların bağlanmasına olanak tanır.

29 Kasım 2023

Satıcı Destek Hizmeti

Merchant Center'da yapılması gereken kimlik doğrulaması için VERIFY_IDENTITY_IN_MERCHANT_CENTER harici işlem türü eklendi.

POS hizmeti

PosStore alanına matching_status ve matching_status_hint alanları eklendi. Bu alanlar, kullanıcıların POS mağazasının Google İşletme Profili mağazasıyla eşleşme durumunu öğrenmesine ve sorun olması durumunda düzeltme ipucu almasına olanak tanır.

15 Kasım 2023

repricingrules ve repricingrules.repricingreports uç noktaları artık desteklenmiyor.

1 Kasım 2023

Kargo Ayarları hizmeti

shipment_type=pickup artık desteklenmiyor.

18 Ekim 2023

Hesap hizmeti

Satıcıların belirli tüketici değerlerine göre kendilerini tanımlamasına olanak tanıyan Business Identity alanı eklendi.

10 Ekim 2023

Kargo ayarları hizmetinin yeni gönderim türü olarak Collection Point eklendi. Teslim noktası teslimatı, üçüncü taraf bir kargo şirketi tarafından (satıcıya ait olmayan) sunulan bir hizmettir.Bu hizmet kapsamında ürünler doğrudan eve teslim edilmek yerine üçüncü tarafla ilişkili bir konuma (ör. UPS erişim noktaları) teslim edilir.

18 Eylül 2023

YER ayarları hizmeti

Kullanıcıların çok kanallı deneyimlerini (ör. yerel vitrin ve teslim alma ayarları) ayarlamalarına olanak tanımak için setOmnichannelExperience yöntemi eklendi. Bu özellik şu anda yalnızca POS sağlayıcısı bu tür ayarları etkinleştirmek için güvenilir olan kullanıcılar tarafından kullanılabilir.

7 Eylül 2023

Google ile Satın Al özelliğinin kullanımdan kaldırılması

GetBuyOnGoogleProgramStastus yöntemine yeni bir DEPRECATED durumu ekleme. Programı bu durumdayken yeniden etkinleştirmek veya duraklatmak mümkün değildir.

4 Eylül 2023

Satıcı Destek Hizmeti

Hesap düzeyinde çözülmesi gereken ürün sorunları için FIX_ACCOUNT_ISSUE yerleşik işlemi eklendi. Ulusal bir yetkiliden gerekçe sunmak için kullanılacak SHOW_ADDITIONAL_CONTENT yerleşik işlemi eklendi.

28 Ağustos 2023

Promosyonlar hizmeti

Promotions hizmetinde list yönteminin erişimini sınırlıdan herkese açık olarak değiştirin.

22 Ağustos 2023

Satıcı Destek Hizmeti

Satıcı Destek Hizmeti kullanıma sunuldu. Bu hizmet, hesap sorunları ve ürün sorunları için destek içeriği sağlar.

4 Ağustos 2023

Raporlar Hizmeti

Raporlar hizmetine Yakın Rekabetçiler Görünürlük Rekabeti raporu eklendi.

Daha fazla bilgi için raporlama kılavuzlarımızı inceleyin.

25 Temmuz 2023

POS Hizmeti

Envanter Kaynağı

Satıcıların envanterleriyle birlikte teslim alma bilgilerini gönderebilmesi için pickup_method ve pickup_sla alanlarını ekleyin.

14 Temmuz 2023

Raporlar Hizmeti

Görünürlük Rekabeti raporları Raporlar hizmetine eklendi.

Daha fazla bilgi için raporlama kılavuzlarımızı inceleyin.

7 Temmuz 2023

Ürün Servisi

Ürün Kaynağı

3D model resminin URL'sini sağlamak için virtualModelLink eklendi.

4 Temmuz 2023

Ürün Servisi

Ürün Kaynağı

Ürün sertifikaları sağlamak için certifications alanını ekleyin (ör. AB EPREL veritabanına dayalı ürünlerin enerji verimliliği etiketlemesi için).

26 Haziran 2023

Kargo Ayarları hizmeti

Yerel sipariş karşılama

Satıcıların, n gün yerel teslimat için yapılandırılmış bir kargo hizmeti varsa n+1 gün yerel teslimat göstermeyi devre dışı bırakmasına olanak tanımak için no_delivery_post_cutoff alanı eklendi.

29 Mayıs 2023

Promosyonlar hizmeti

Promotions hizmeti için list yöntemi eklendi.

Öneri hizmeti

Öneriler hizmetinin ReportInteraction yönteminde etkileşimi reddetmeyi etkinleştirin.

9 Mayıs 2023

Cloud Perakende Hedefi

Cloud Perakende Ek Özellikleri

Cloud Retail ek mülkler alanını ekleyin. Bu, Cloud Retail hedefini kullanan müşteriler tarafından kullanılması amaçlanan yinelenen bir alandır. Bu alan kullanıldığında bulut perakende programı kullanılırken kullanılabilir. Bu, Google Cloud Retail ürün modelindeki özellikler alanıyla eşlenir.

22 Mayıs 2023

Promosyonlar hizmeti

Promotions hizmeti için list yöntemi eklendi.

11 Nisan 2023

Kargo Ayarları hizmeti

Yerel sipariş karşılama

Yeni bir gönderim ayarı oluşturan satıcılar için yerel teslimat sipariş karşılama seçeneği eklendi. Yeni storeConfig alanında yerel mağazalarla ilgili ayarlarını yapılandırabilirler. Yerel teslimat hizmeti sunan mağazaların hizmet yarıçapı, son sipariş saati ve mağaza kodları da buna dahildir.

3 Nisan

Öneriler Hizmeti

Öneriler Hizmeti kullanıma sunuldu. Bu hizmet, satıcı hesabınızın performansını iyileştirmenin önerilen yollarını sunar ve faydalı önerilere yapılan satıcı tıklamalarını bildirmenize olanak tanır.

20 Şubat 2023

Hesaplar Hizmeti

Hesap kaynağı

Hesaplar kaynağına yeni bir bölüm Account.ConversionSettings eklendi.

ConversionSources Hizmeti

Dönüşüm kaynaklarını yönetmeyi destekleyen Dönüşüm Kaynakları hizmeti eklendi (Merchant Center'daki Dönüşüm Ayarları bölümünün bir parçasıdır).

16 Şubat 2023

Kargo Ayarları hizmeti

Mağaza kodu doğrulaması

Gönderim ayarları güncellenmeden önce mağaza kodları, satıcıya ait olduklarından emin olmak için doğrulanır.

Yerel envanter reklamları (YER) satıcı doğrulaması

Satıcı kimliğinin kayıtlı olduğu programlar artık kargo ayarları güncellenmeden önce doğrulanmaktadır. Satıcılar aşağıdaki programlardan birinde olmalıdır:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 Şubat 2023

Promosyonlar Hizmeti

Promosyonlar hizmetini, yerel contentLanguage desteğiyle 6 ek targetCountry seçeneğe genişletin.

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

12 Ocak 2023

Ürün Servisi

Ürün Kaynağı

Yaşam tarzı resimlerinin URL'lerini sağlamak için lifestyleImageLinks eklendi.

24 Kasım 2022

Promosyon Hizmeti

Promotions.PromotionStatus bölümüne yeni bir "promotionStatus" alanı eklendi. Bu, salt okunur bir alandır.

15 Kasım 2022

Raporlar Hizmeti

Pazar Analizleri raporları Raporlar hizmetine eklendi.

Artık Raporlar hizmetini aşağıdakiler için sorgulayabilirsiniz:

Daha fazla bilgi için raporlama kılavuzlarımızı inceleyin.

7 Kasım 2022

Veri Feed'leri Hizmeti

Veri feed'leri hizmeti için feedLabel desteği eklendi.

14 Eylül 2022

Herhangi bir dizeyi kabul edecek şekilde feedLabel güncellendi.

9 Ağustos 2022

Ürünler için feedLabel eklendi.

Artık teklif kimlikleri için ülkeyi belirtmek üzere targetCountry yerine feedLabel kullanabilirsiniz. Teklif kimlikleri artık online:language:feedLabel:offerId olarak oluşturulur.

feedLabel, geriye dönük uyumluluk için mevcut feed'lerdeki targetCountry değerinizle otomatik olarak dolduruldu.

targetCountry özelliği kullanımdan kaldırıldı.

Content API for Shopping, dünya genelindeki teklifleri desteklemek için targetCountry alanının desteğini sonlandırdı. Bunun yerine, hedef ülkelerinizi belirtmek için shipping alanını kullanmanızı öneririz.

targetCountry artık feedLabel içinde sağladığınız değerle otomatik olarak doldurulur.

Daha fazla bilgi için Feed etiketi, Content API for Shopping'de hedef ülkeyi değiştiriyor başlıklı blog yayınını inceleyin.

8 Aralık 2021

Hesaplar Hizmeti

Hesap kaynağı

Hesaplar kaynağına Account.AutomaticImprovements adlı yeni bir bölüm eklendi.

Bu yeni bölüm, satıcıların öğeleri otomatik olarak güncellemesine, resimleri ve gönderim ayarlarını iyileştirmesine olanak tanıyacak.

25 Ekim 2021

Promosyon Hizmeti

Promotion API'ye Get Promotion ekleme.

11 Ekim 2021

Shipping Settings API

Satıcıların WarehouseBasedDeliveryTime kaynağında kullanılabilecek depoları yönetmelerine olanak tanımak için ShippingSettings kaynağına yeni bir warehouse alanı eklendi.

Depo adına göre depo alanına referans vermek için WarehouseBasedDeliveryTime alanına yeni bir warehouseName alanı ekleyin.

4 Ekim 2021

Hesaplar Hizmeti

Hesap Kaynağı

Accounts.BusinessInformation bölümüne "phone_verification_status" adlı yeni bir alan eklendi. Bu, Accounts.VerifyPhoneNumber tarafından ayarlanan salt okunur bir alandır.

13 Eylül 2021

BuyOnGooglePrograms hizmeti

BuyOnGoogleProgramStatus kaynağı

BuyOnGooglePrograms.BuyOnProgramStatus kaynağına online satış kanallarını, iş modellerini ve müşteri hizmetleri telefonunu temsil eden yeni alanlar eklendi.

Yeni UpdateBuyOnGoogleProgramStatus yöntemi

Genişletilmiş BuyOnGooglePrograms.BuyOnProgramStatus kaynağını güncellemenize olanak tanıyacak yeni bir UpdateBuyOnGoogleProgramStatus yöntemi eklendi.

6 Eylül 2021

Hesaplar Hizmeti

Hesap kaynağı

Accounts.BusinessInformation bölümüne "korean_business_registration_number" adlı yeni bir alan eklendi. Bu alan yalnızca açıkça boş bir dize olarak ayarlanırsa temizlenir.

30 Ağustos 2021

Promosyon Hizmeti

Promosyon ekleme özelliğinin kullanılabildiği yeni bir promosyon hizmeti eklendi.

Sipariş Hizmeti

Gönderimden önce para tahsil etmek için yeni bir yöntem orders/captureOrder eklendi.

Yeni sipariş iptal nedeni FAILED_TO_CAPTURE_FUNDS

Ürün Servisi

Ürün Kaynağı

Ürün boyutlarını ve ağırlığını belirtmek için productLength, productHeight, productWidth ve productWeight eklendi.

9 Ağustos 2021

RepricingRule Hizmeti

RepricingRule Türü

RepricingRuleType alanı için yeni enum değeri.

TYPE_SALES_VOLUME_BASED ve TYPE_COMPETITIVE_PRICE eklendi.

17 Mayıs 2021

Sipariş İade Etiketi Hizmeti

CreateReturnRequest'e yeni bir "product_id" alanı eklendi. Satıcılar, iade edilecek öğeyi tanımlamak için product_id veya line_item_id özelliğini belirtebilir.

Ürün Servisi

Mevcut ürünleri güncellemek için yeni bir yöntem eklendi. Bir ürünün tamamını değil, yalnızca güncellenmesi gereken alanlarını sağlayarak ürünü güncelleyebilirsiniz.

3 Mayıs 2021

Sipariş İade Etiketi Hizmeti

Satıcı Tarafından Yönetilen İadeler (MMR) için etiket yüklemeyle ilgili yeni yöntemler eklendi. Yeni orderreturns.labels.create ile iade etiketlerini yükleyip müşteriyle paylaşabilirsiniz.

26 Nisan 2021

Shipping Settings API

Depo konumuna ve seçilen kargo hizmetine göre tahmini teslimat tarihini hesaplayan kargo hizmetlerini desteklemek için DeliveryTime alanında yeni bir warehouseBasedDeliveryTimes alanı eklendi.

Tahmini teslimat tarihini hesaplamak için geçerli hizmetlerin adlarını döndürmek üzere CarriersCarrier nesnesinde yeni eddServices alanı.

12 Nisan 2021

Ürün Servisi

Ürün Kaynağı

Ürün başına en fazla 2 beden türünü destekleyen yeni additionalSizeType alanı.

Gönderim alanında yapılan değişiklikler: Teklif düzeyinde kargo hızı sağlamak için ProductShipping alanına minHandlingTime, maxHandlingTime, minTransitTime ve maxTransitTime eklendi.

28 Ocak 2021

Hesaplar Hizmeti

AccountLabel ve Account kaynaklarına otomatik etiket desteği eklendi. Daha fazla bilgi için CSS etiketi yönetimi kılavuzundaki CSS etiketi türleri bölümüne bakın.

5 Ekim 2020

CSSES Hizmeti

CSS Kaynağı

CSS alanlarıyla ilgili bilgileri almak ve bunlara etiket atamak için yeni bir csses hizmeti eklendi. AccountLabel kaynağı artık CSS grup düzeyinde etiketler oluşturmak ve listelemek için de kullanılabilir. Daha fazla bilgi için CSS etiketi yönetimi başlıklı makaleyi inceleyin.

24 Ağustos 2020

Ürün Servisi

Ürün Kaynakları

Teklifleri belirli ülkelerde reklamcılıktan hariç tutmak için yeni shoppingAdsExcludedCountries alanı.

Productstatuses Kaynağı

destinationStatuses nesnesinde, targetCountry'den daha fazla teklif durumu bilgisi sağlayan yeni approvedCountries, pendingCountries ve disapprovedCountries alanları.

Yeni itemLevelIssues.applicableCountries alanı.

10 Ağustos 2020

Hesaplar Hizmeti

CSS Center için Merchant Center hesap etiketlerini yönetmeye yönelik yeni bir AccountLabel kaynağı eklendi. CSS Center kullanıcıları artık Merchant Center hesaplarını listeleyebilir ve accounts.list, accounts.get ve accounts.updatelabels yöntemleriyle bu hesaplara etiket atayabilir. Daha fazla bilgi için CSS etiketi yönetimi başlıklı makaleyi inceleyin.

19 Haziran 2020

Ürün Servisi

Ürün Kaynağı

Yeni alanlar

Yeni productDetails, productHighlights, subscriptionCost ve canonicalLink alanları.

2 Haziran 2020

Sipariş Hizmeti

İade olmadan geri ödeme başlatmak için yeni yöntemler eklendi. Yeni orders.refunditem ve orders.refundorder ile, müşteri tarafından iade edilmemiş siparişler için bile geri ödeme başlatabilirsiniz.

27 Nisan 2020

Sipariş İadeleri Hizmeti

acknowledge ve process adlı yeni yöntemler, okuma yöntemleri (list, get) için yeni filtreler ve alanlar eklendi.

GMB bağlama

GMB hesap kimliğini kullanarak Merchant Center hesaplarını bir GMB hesabına bağlama özelliği eklendi.

14 Nisan 2020

Settlement Report API'leri

Tahsilat raporları almak için yeni bir hizmet eklendi.

9 Mart 2020

Yerel envanter API'si

Yerel envanter verilerini göndermek için yeni bir hizmet eklendi.

2 Mart 2020

Pubsub bildirim ayarları API'si

Pubsub bildirimleri ayarlarını yönetmek için yeni bir hizmet eklendi.

3 Aralık 2019

Ürün Servisi

Çok müşterili hesap ek Content API feed'leri için destek eklendi.

11 Eylül 2019

Sipariş Hizmeti

Siparişlerde teslim alma gönderimleri ve ilgili korumalı alan özellikleri için destek eklendi.

14 Ağustos 2019

Yeni hizmetler

Google ile Satın Al için yeni Returnpolicy ve Returnaddress hizmetleri eklendi.

Sipariş Hizmeti

Sipariş kaynağı

Yeni alan

Yeni quantityUndeliverable alanı.

7 Ağustos 2019

Sipariş Hizmeti

Sipariş kaynağı

Yeni alanlar

Sipariş kaynağına yeni loyaltyInfo ve invoiceReceivingEmail alanları eklendi.

1 Temmuz 2019

Ürün Servisi

Ürünler hizmetine eklenen ek Content API feed'leri için destek.

11 Haziran 2019

Sipariş Hizmeti

Order ve TestOrder Kaynakları

Fiyat düzenlemesi eklendi

Promosyonların uygulanması nedeniyle orijinal satır öğesi fiyatında ve vergisinde yapılan düzenlemeyi içeren yeni bir lineItem[].adjustments alanı eklendi.

14 Şubat 2019

Bu sürümde yapılan değişiklikler

Provalar artık desteklenmiyor

dryRun parametresi, 2.1 sürümünden kaldırıldı. Bu durum tüm API çağrıları için geçerlidir.

Artık desteklenmeyen yama yöntemleri

Aşağıdaki hizmetler artık patch yöntemini desteklemiyor:

  • Hesaplar
  • Accounttax
  • Veri feed'leri
  • Liasettings
  • Shippingsettings

HTTP BATCH yöntemlerinin kaldırılması

Tüm HTTP BATCH yöntemleri v2.1 sürümünden kaldırıldı. Bunun yerine customBatch politikasını kullanın. Etkilenen hizmetler şunlardır:

  • Hesaplar
  • Accountstatuses
  • Veri feed'leri
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Poz
  • Ürünler
  • Productstatuses
  • Shippingsettings

Hesaplar Hizmeti

Güncelle

İstekte bulunan businessInformation ve googleMyBusinessLink alanları, Content API v2'nin ilk lansmanından sonra kullanıma sunulmuştur. Bu nedenle, satıcıların bu iki alandaki bilgileri update ile yanlışlıkla silmesini engelleyen bir güvenlik önlemi vardır.

Satıcılar, v2 sürümünde bu alanları silmek için açıkça boş bir gövde ( {}) sağlamalıdır. 2.1 sürümünde, boş bir gövde sağlarsanız veya sağlamazsanız alanlar silinir.

Hesap kaynağı

AdWords -> Google Ads marka değişikliği

AdWords'in Google Ads olarak değişmesiyle AdWords ile ilgili aşağıdaki alanlar yeniden adlandırıldı:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Desteği sonlandırılan alanların ve değerlerin kaldırılması

Desteği sonlandırılan reviewsUrl alanı kaldırıldı. Ayrıca, adsLinks, googleMyBusinessLink ve youtubeChannelLinks için bağlantı durumu inactive kaldırıldı.

Accountstatuses Hizmeti

AccountStatus Kaynağı

dataQualityIssues özelliğinin kaldırılması

Bunların yerini itemLevelIssues aldı.

Veri Feed'i Hizmeti

Veri feed'i kaynağı

Desteği sonlandırılan alanların kaldırılması

contentLanguage, targetCountry ve intendedDestinations alanları kaldırıldı ve targets'te country, language, includedDestinations ve excludedDestinations ile değiştirildi.

Ürün envanteri güncellemesinin kaldırılması

product inventory update türündeki feed'ler kaldırıldı.

Envanter Hizmeti

2.1 sürümünde, 2. sürüm inventory hizmeti kaldırıldı ve iki yeni özellikle değiştirildi:

  • Kısmi ürün güncellemeleri için yeni Ek Feed'leri kullanın.
  • Yerel ürün güncellemeleri için yeni localinventory hizmetini kullanın.

Sipariş Hizmeti

CancelLineItem

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

CustomBatch

CustomBatch, 2.1 sürümünden kaldırıldı.

InStoreRefundLineItem

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

Geri ödeme

Bu yöntem kaldırıldı. Bunun yerine returnRefundLineItem politikasını kullanın.

ReturnLineItem

Bu yöntem kaldırıldı. Bunun yerine geri ödeme tutarı sağlamadan returnRefundLineItem kullanın.

ReturnRefundLineItem

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

ShipLineItem

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

Order ve TestOrder Kaynakları

Yeni promosyon biçimi

2.1 sürümünde yeni bir promosyon biçimi vardır. Promosyon içeren test siparişleri oluşturamazsınız.

Desteği sonlandırılan alanların kaldırılması

paymentMethod alanı kaldırıldı ve billingAddress ile predefinedBillingAddress, sırasıyla Order ve TestOrder'te üst düzey alanlar oldu.

Ayrıca customer.explicitMarketingPreference, hem Order hem de TestOrder öğesinden kaldırılıp customer.marketingRightsInfo ile değiştirildi.

Desteği sonlandırılan customer.email alanı kaldırıldı.

Order kaynağındaki promotions alanının biçimi değişti.

Orderpayments Hizmeti

Bu hizmet, 2.1 sürümünden kaldırılmıştır.

Ürün Servisi

insert'ten gelen yanıt yalnızca aşağıdaki özellikleri içerir:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Ölümcül olmayan uyarılar ve hatalar artık yanıtta döndürülmez. Bu, feed kuralları ve diğer gelişmiş feed yönetimi özellikleriyle daha iyi entegrasyon sağlar.

Eklenen bir ürünün get veya list tarafından alınabilmesi için artık birkaç dakikalık bir gecikme var.

Döndürülen teklif kimliğinin artık girişteki teklif kimliğiyle aynı olacağı garanti edilmez.

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

Ürün Kaynağı

CustomGroups, yinelenen customAttributes ile değiştirildi

Daha önce, özel özellikler v2'de aynı özel grubun altına ekleyerek gruplandırılabiliyordu. Özel özellikler artık 2.1 sürümünde yinelenebilir olduğundan özel gruplara ihtiyaç duyulmaz.

Özel özelliklerde artık orijinal value alanına ek olarak bir groupValues alanı da bulunuyor. Bu alanlardan tam olarak biri ayarlanmalıdır. Yani aynı anda ayarlanamaz veya atlanmamalıdır.

Satıcılar v2 ve v2.1 arasında geçiş yapabileceğinden, ürünlerde yinelenen özel özellikler bulunabilir. Özel gruplar en fazla iki düzeye sahip olduğundan bu özellikler v2'de temsil edilemez. Bu durumda, özel özellik grubu kısaltılır.

customAttributes özelliğindeki tür ve birimin kaldırılması

2.1 sürümünde özel özellikler artık type ve unit içermeyecek. Bunun yerine birimler value'e (varsa) eklenmeli ve türler otomatik olarak algılanmalıdır. Örneğin, v2.1'de value olarak "1,23 avro" veya "5,6 cm" kullanın.

ProductTypes, productType ve additionalProductTypes'in yerini alır.

Daha önce ürün türleri, ilk türün tekil alanda productType, geri kalanın ise yinelenen alanda additionalProductTypes olduğu iki alanda depolanıyordu. 2.1 sürümünde bu iki alan tek bir yinelenen alan productTypes ile değiştirildi.

Hedefler özelliği, includedDestinations ve excludedDestinations ile değiştirildi

Hedefler, v2'de tekrarlanan destinations alanında hedef adı ve intent çiftlerinin listesi olarak giriliyordu. Bu alanın yerine aşağıdaki iki yinelenen alan kullanılmaktadır: includedDestinations ve excludedDestinations. Varsayılan olarak etkinleştirilen hedeflerin includedDestinations.'e dahil edilmesi gerekmez. Bu, feed'lerdeki hedef geçersiz kılmalarının yapılandırmasıyla eşleşir.

AdWords'in Google Ads olarak değişmesiyle AdWords ile ilgili aşağıdaki alanlar yeniden adlandırıldı:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Desteği sonlandırılan alanların kaldırılması

Aşağıdaki kullanımdan kaldırılmış alanlar kaldırıldı:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Hizmeti

Get ve List

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

Liste

includeInvalidInsertedItems parametresi kaldırıldı. Artık tüm ürünler geçerli olup olmadıklarından bağımsız olarak döndürülür. Yani list, includeInvalidInsertedItems her zaman true olarak ayarlanmış gibi davranır.

ProductStatus Kaynağı

DestinationsStatuses

destinationStatuses içindeki intention, approvalStatus ve approvalPending alanları, approved, disapproved veya pending değerlerinden biri olabilecek bir dize olan status ile değiştirildi.

dataQualityIssues özelliğinin kaldırılması

Bunların yerini itemLevelIssues aldı.