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

ShippingSettings kaynağı, hesabınızın ve hesapla ilişkili tüm alt hesapların kargo ayarlarını almanıza ve 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/v1/accounts/{ACCOUNT_ID}/shippingSettings

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

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

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

Daha fazla bilgi için Method: accounts.shippingSettings.insert başlıklı makaleyi inceleyin.

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

Content API for Shopping ile Accounts alt API'sindeki Shipping settings kaynağının karşılaştırmasını aşağıda bulabilirsiniz:

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

Aşağıdaki listede, Content API for Shopping ile karşılaştırıldığında Accounts alt API'sindeki gönderim ayarları kaynağında yapılan önemli güncellemeler belirtilmiştir:

  1. Merchant API kullanıcılarının aynı davranışı elde etmek için {NAME} alanına accounts/{ACCOUNT_ID}/shippingSettings değerini girmesi gerekir.
  2. Merchant API, yer 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. Merchant API'deki bir hizmet, birden fazla teslimat ülkesini destekler.
  4. Merchant API, Content API'deki shippingsettings.list yönteminin aksine, kargo ayarları için bir liste yöntemi sağlamaz.

Desteklenen yeni alanlar

Accounts alt API'sindeki kargo ayarları kaynağı, Content API for Shopping'e kıyasla aşağıdaki yeni alanları destekler:

  1. warehouses: Envanterin depolandığı ve işlendiği 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 aynı anda Merchant API ve Merchant Center kullanıcı arayüzünü kullanarak kargo ayarlarını güncellemeye çalıştığında ortaya çıkan eşzamansız sorunları çözmek için tasarlanmıştır.

Yeniden adlandırılan alanlar

Accounts alt API'sindeki Shipping settings kaynağında aşağıdaki alanlar yeniden adlandırıldı:

Content API for Shopping Kargo ayarları kaynağı Açıklama
service services Tek bir kargo hizmeti.
service.name services.serviceName Hizmetin, Merchant Center hesabınızda benzersiz olması gereken serbest biçimli adı.
service.deliveryCountry services.deliveryCountries Kargo 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 nakliyede 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 nakliyede geçirdiği maksimum iş günü sayısı.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Bir sipariş gönderilmeden önce geçen minimum iş günü sayısı.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Bir sipariş gönderilmeden önce geçen 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.

Kaldırılan yöntemler

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

Kaldırılan alanlar

Content API for Shopping'deki aşağıdaki alanlar Merchant API'den kaldırıldı. Merchant API, bu alanlar için herhangi bir alternatif sunmaz.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

Yöntemler

Content API for Shopping ve Shipping settings kaynağındaki 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
list Evet Hayır
getSupportedCarrier Evet Hayır
getSupportedHolidays Evet Hayır
Önceki
Migrate region management
Sonraki
Migrate online return policy management