Content API for Shopping'den gönderim ayarlarını taşıyın

ShippingSettings kaynağı, hesabınızın ve ilişkili tüm alt hesapların kargo ayarlarını alıp güncellemenize olanak tanır. Hesabınızın kargo ayarlarını nasıl ekleyeceğiniz veya yöneteceğiniz hakkında daha fazla bilgi için Kargo ayarlarına genel bakış başlıklı makaleyi inceleyin.

Kargo ayarları bilgilerini okumak için Merchant API'yi kullanmak istiyorsanız aşağıdaki istekleri kullanın:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings

{ACCOUNT_ID} değerini Merchant Center hesabınızın benzersiz tanımlayıcıyla değiştirin.

Kargo ayarlarını güncellemek için Merchant API'yi kullanmak istiyorsanız aşağıdaki istekleri kullanın:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert

Daha fazla bilgi için Yöntem: accounts.shippingSettings.insert bölümüne bakın.

Content API for Shopping ile Merchant API karşılaştırması

Content API for Shopping ile Satıcı Gönderim Ayarları API'sinin karşılaştırmasını aşağıda bulabilirsiniz:

	Content API	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{ACCOUNT_ID}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert
Tanımlayıcılar	{ACCOUNT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

Aşağıdaki listede, Merchant Shipping settings API'de Content API for Shopping'e kıyasla yapılan önemli güncellemeler belirtilmiştir:

1. Merchant API kullanıcılarının aynı davranışı elde etmek için accounts/{ACCOUNT_ID}/shippingSettings değerini {NAME} alanına koyması gerekir.
2. Merchant API, konum grupları gibi özel alanlarda okuma ve yazma işlemlerini desteklemez. Yer grupları gibi özel alanlar yalnızca bölge hizmeti kullanılarak okunabilir veya yazılabilir.
3. WarehouseBasedDeliveryTime parametresinin Merchant API için ayarlanma şekli, Content API for Shopping'e kıyasla farklıdır. Merchant API kullanıyorsanız shippingsettings.warehouses altında depo bilgilerini tanımlamanız gerekir. Ardından her kargo hizmeti, warehouseBaseDeliveryTime altındaki depo adı aracılığıyla depoya referans verebilir.
4. Merchant API'deki bir hizmet birden fazla teslimat ülkesini destekler.

Desteklenen yeni alanlar

Satıcı Gönderim Ayarları API'si, Content API for Shopping'e kıyasla aşağıdaki yeni alanları destekler:

1. Depolar: Envanteri depolayan ve işleyen bir sipariş karşılama deposu hakkında bilgi sağlar.
2. Bağlılık programları: Merchant API kullanıcıları, kargo ayarlarına bağlılık programı bilgilerini girebilir.
3. Etag: Etag, farklı kullanıcılar Merchant API ve Merchant Center kullanıcı arayüzünü aynı anda kullanarak kargo ayarlarını güncellemeye çalıştığında asenkron sorunları çözmek için tasarlanmıştır.

Yeniden adlandırılan alanlar

Merchant API'de aşağıdaki alanlar yeniden adlandırıldı:

Content API for Shopping	Satıcı Kargo Ayarları API'si	Açıklama
service	services	Tek bir kargo hizmeti.
service.name	services.serviceName	Merchant Center hesabınızda benzersiz olması gereken hizmetin serbest biçimli adı.
service.deliveryCountry	services.deliveryCountries	Gönderim hizmetinin geçerli olduğu ülkenin CLDR bölge kodu.
service.currency	services.currencyCode	Bu hizmetin geçerli olduğu para biriminin CLDR kodu.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Bir siparişin transfer sırasında geçirdiği minimum iş günü sayısı. Örneğin, 0 aynı gün teslimat, 1 ise sonraki gün teslimat anlamına gelir.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Bir siparişin transfer sırasında geçirebileceği maksimum iş günü sayısı.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Bir siparişin gönderilmeden önce geçen minimum iş günü sayısı.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Bir siparişin gönderilmeden önce geçen maksimum iş günü sayısı.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Son sipariş saati için saat dilimi tanımlayıcısı.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	Posta kodu grubunun adı.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	Ürünün nakliye süresi etiketi.
service.rate_group	services.rateGroups	Kargo ücreti grubu tanımları.
service.rate_group.subtable	services.rateGroups.subtables	Alt tabloların listesi.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Operatör ücretlerinin listesi.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Aynı minimum sipariş değerini paylaşan mağaza kodu gruplarının listesi.

Kullanımdan kaldırılan yöntemler

Tek bir istekte birden fazla hesabın gönderim ayarlarını almak ve güncellemek için shippingsettings.custombatch'i kullanamazsınız.

Desteği sonlandırılmış alanlar

Content API'deki aşağıdaki alanların Merchant API'de desteği sonlandırıldı. Merchant API bu alanlar için herhangi bir alternatif sağlamaz.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

Yöntemler

Content API for Shopping ve Merchant Shipping settings API'deki yöntemlerin karşılaştırmasını aşağıda bulabilirsiniz:

Yöntem	Content API for Shopping	Merchant API
customBatch	Evet	Hayır
get	Evet	Evet
update	Evet	Hayır
insert	Hayır	Evet
getSupportedCarrier	Evet	Hayır
getSupportedHolidays	Evet	Hayır