v1beta'dan v1'e taşıma

Bu kılavuz, Merchant API v1beta'den v1'ye (Genel Kullanıma Sunulan ilk sürüm) geçiş yapmanıza yardımcı olur. v1 sürümünde, birkaç güncelleme ve kod güncellemeleri gerektirebilecek bazı değişiklikler yapıldı. Bu değişiklikler, API'yi basitleştirmek ve Merchant Center hesabınızın yönetimini iyileştirmek için tasarlanmıştır.

Temel farklar

v1beta sürümünden v1 sürümüne geçerken dikkat etmeniz gereken en önemli değişiklikler şunlardır:

• Merchant API'yi kullanmak için en az bir API geliştiricinin tek seferlik kaydı: İletişim bilgilerinizi sağlamak için registerGcp yöntemini (kimlik doğrulama için kullanılan her Google Cloud projesi için yalnızca bir kez) çağırmanız gerekir. Bu sayede API'yi kullanabilir ve Merchant API ile ilgili güncellemeleri ve duyuruları alabilirsiniz. Bu adım tamamlanana kadar v1 veya v1alpha API'lerini kullanamazsınız. Talimatlar için Geliştirici olarak kaydolma başlıklı makaleyi inceleyin.

• Ürün adı kodlaması: ProductInput.name ve Product.name alanları, doldurulmamış base64url (RFC 4648 Bölüm 5) kodlamasını destekler. Aşağıdaki yönergeleri uygulayın:

  • Dizenin kodlanmadan önce contentLanguage~feedLabel~offerId biçiminde olması gerekir.

  • Ürün adınızda Merchant API tarafından kullanılan karakterler veya URL'de ayrılmış karakterler (ör. aşağıdaki karakterler) varsa kodlama zorunludur:

    % . + / : ~ , ( * ! ) & ? = @ # $
    

  • Ürün adınız contentLanguage~feedLabel~offerId biçimine uyuyorsa ve Merchant API veya URL'de ayrılmış karakterler tarafından kullanılan herhangi bir karakter içermiyorsa kodlama olmadan düz biçimi kullanabilirsiniz.

  • Tutarlı ve doğru ayrıştırma için tüm ürün adlarında doldurulmamış base64url kodlaması kullanmanızı öneririz.

• Ürün düzeyinde vergi bilgilerinin kaldırılması: taxes ve taxCategory.

• Product.attributes yeniden adlandırıldı: Product.attributes alanı, Product.productAttributes olarak yeniden adlandırıldı.

• Ürün düzeyinde vergi bilgilerinin kaldırılması: taxes ve taxCategory alanları Product.productAttributes nesnesinden kaldırıldı. Daha fazla bilgi için vergi hakkındaki Google Merchant Center Yardım Makalesi'ni inceleyin.

• GTIN alanında yapılan değişiklikler: Product.productAttributes nesnesindeki gtin alanı, birden fazla değer içerebileceğini daha iyi yansıtmak için gtins olarak yeniden adlandırıldı. OrderTrackingSignals.lineItemDetails nesnesindeki gtin alanı artık array ve gtins olarak yeniden adlandırıldı.

• Kanal alanı kaldırıldı: channel alanı ürünlerden, ürün girişlerinden ve veri kaynaklarından kaldırıldı. Yalnızca fiziksel mağazalarda satılan ürünleri net bir şekilde belirtmek için yeni bir Boole alanı olan legacyLocal kullanıma sunuldu. Not: legacyLocal alanı, taşıma işlemine yardımcı olan bir yardımcı alandır ve çevrimiçi ve yerel pazarlama yöntemleri tek bir ürün kaynağıyla tam olarak hedeflenebildiğinde desteği sonlandırılacaktır. Daha fazla bilgi için aşağıdaki bölümdeki tabloya bakın.

• Bölgesel ve yerel envanter özellikleriyle ilgili yeni alanlar:

  • name, account ve region dışındaki tüm RegionalInventory alanları artık regionalInventoryAttributes adlı yeni bir nesne altında yer alıyor. Örneğin, RegionalInventory.price özelliği artık RegionalInventory.regionalInventoryAttributes.price altında yer alıyor.
  • name, account ve storeCode dışındaki tüm LocalInventory alanları artık localInventoryAttributes adlı yeni bir nesne altında yer alıyor. Örneğin, LocalInventory.price özelliği artık LocalInventory.localInventoryAttributes.price altında yer alıyor.

• customAttributes özelliğinin bölgesel ve yerel envanterlerden kaldırılması: customAttributes alanı hem RegionalInventory hem de LocalInventory kaynaklarından kaldırıldı.

• Geliştirilmiş hesap oluşturma: CreateAndConfigureAccountRequest bölümünden gereksiz users alanı kaldırıldı. İlk kullanıcıyı yeni bir hesapla ilişkilendirmek için tekil user alanını kullanın.

• Belirli özellik türleri dizelerden numaralandırılmış değerlere dönüştürüldü: Product ve Inventory kaynaklarındaki bazı alanlar, tanımlanmış kısa değer listeleriyle birlikte daha iyi veri doğrulaması için string türünden enum türüne dönüştürüldü (örneğin, Product.ProductAttributes.condition alanı artık enum türünde).

• Online iade politikası güncelleme yöntemi kaldırıldı: onlineReturnPolicy.update yöntemi v1 sürümünde kaldırıldı. Bunun yerine onlineReturnPolicy.create yöntemini kullanarak online iade politikası oluşturun.

Taşıma işlemi nasıl yapılır?

Merchant API'nin v1beta sürümünün 28 Şubat 2026'da kullanımdan kaldırılması planlanmaktadır. Desteği sonlandırma takvimi hakkında daha fazla bilgi için Merchant API sürüm oluşturma kılavuzuna bakın.

• Taşıma işlemindeki ilk adımınız, tek seferlik geliştirici kaydı yapmaktır (Bkz. Geliştirici olarak kaydolma). v1 yöntemlerinin çalışması için kimlik doğrulama amacıyla kullandığınız her Google Cloud projesi için registerGcp yöntemini çağırmanız gerekir.

• API'leri nasıl çağırdığınızdan (REST, gRPC veya istemci kitaplıklarını kullanarak) bağımsız olarak aşamalı olarak taşıma yapabilirsiniz. Bu, tüm entegrasyonunuzu aynı anda güncellemek zorunda kalmadan kodunuzu tek seferde bir API olacak şekilde güncelleyip taşıyabileceğiniz (örneğin, Products API'sini v1 API'sine taşırken Accounts API'sini v1beta üzerinde tutma) anlamına gelir.

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

Bu tabloda, v1beta ve v1 sürümleri arasında değişen alanların ayrıntılı bir karşılaştırması verilmektedir.