Merchant API'yi kullanarak gönderim ayarları bilgilerini okumak için aşağıdaki istekleri kullanın:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
{accountId} kısmını Merchant Center hesabınızın benzersiz tanımlayıcısıyla değiştirin.
Merchant API'yi kullanarak gönderim ayarları bilgilerini okumak için aşağıdaki istekleri kullanın:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Content API for Shopping ile Merchant API'nin karşılaştırması
Content API for Shopping ve Merchant Shipping settings API'nin örnek karşılaştırmasını aşağıda bulabilirsiniz:
Content API | Satıcı API'sı | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
Tanımlayıcılar | {accountId}/shippingsettings/ {accountId} |
{name} |
Aşağıdaki listede, Content API for Shopping ile karşılaştırıldığında Merchant Shipping Settings API'deki önemli güncellemeler belirtilmiştir:
- Merchant API kullanıcılarının aynı davranışa sahip olmaları için {name} alanına
accounts/{accountId}/shippingSettings
değerini eklemeleri gerekir. - Merchant API, konum grupları gibi özel alanlarda okuma ve yazma işlemlerini desteklemez. Konum grupları gibi özel alanlar yalnızca bölge hizmeti kullanılarak okunabilir veya yazılabilir.
WarehouseBasedDeliveryTime
ayarlama yöntemi Content API for Shopping'den farklı şekilde Merchant API'ye uygulanır. Merchant API kullanıyorsanız depo bilgilerinishippingsettings.warehouses
altında tanımlamanız gerekir. Daha sonra her gönderim hizmeti,warehouseBaseDeliveryTime
altındaki depo adı üzerinden depoya referans verebilir.- Merchant API'deki bir hizmet, birden fazla teslimat ülkesini destekler.
Desteklenen yeni alanlar
Merchant Shipping settings API, Content API for Shopping'e kıyasla aşağıdaki yeni alanları destekler:
- Depolar: Envanteri depolayan ve yöneten bir sipariş karşılama deposu hakkında bilgi sağlar.
- Bağlılık programları: Merchant API kullanıcıları, bağlılık programı bilgilerini gönderim ayarlarına girebilir.
- Etag: Etag, farklı kullanıcılar Merchant API ve Merchant Center kullanıcı arayüzünü aynı anda kullanarak gönderim ayarlarını güncellemeye çalıştığında eşzamansız sorunları çözmek için tasarlanmıştır.
Yeniden adlandırılan alanlar
Aşağıdaki alanlar, Merchant API'de yeniden adlandırıldı:
Content API for Shopping | Merchant Shipping Settings 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 nakliye sırasında harcadığı 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 nakliye sırasında harcadığı maksimum iş günü sayısı. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Bir sipariş gönderilmeden önce harcanan minimum iş günü sayısı. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Bir sipariş gönderilmeden önce harcanan maksimum iş günü sayısı. |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
Son sipariş saatinin 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 |
Kargo ü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
Birden fazla hesabın gönderim ayarlarını tek bir istekte almak ve güncellemek için shippingsettings.custombatch
aracını kullanamazsınız.
Kullanımdan kaldırılan alanlar
Aşağıdaki alanlar Merchant API'de kullanımdan kaldırılmıştır. Merchant API'nin bu alanlar için alternatif sağlamadığını unutmayın.
Content API for Shopping | Satıcı API'sı | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| YöntemlerContent API for Shopping ve Merchant Shipping settings API'deki yöntemlerin karşılaştırması aşağıda verilmiştir:
|