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

ShippingSettings kaynağı, hesabınızın ve hesabınızla 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ı ekleme veya yönetme hakkında daha fazla bilgi için Kargo ayarlarının genel görünümü başlıklı makaleyi inceleyin.

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

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

{ACCOUNT_ID} kısmını 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 üzere aşağıdaki istekleri kullanın:

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

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

Content API for Shopping ile Merchant API arasındaki karşılaştırma

Content API for Shopping ile Hesaplar alt API'sindeki Kargo ayarları kaynağının karşılaştırmasına dair bir örnek aşağıda verilmiştir:

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, Hesaplar alt API'sindeki Kargo ayarları kaynağında Content API for Shopping'e kıyasla yapılan başlıca güncellemeler belirtilmektedir:

  1. Merchant API kullanıcılarının aynı davranışa sahip olabilmek için accounts/{ACCOUNT_ID}/shippingSettings değerini {NAME} alanına girmesi 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. 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

Hesaplar 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 bir lojistik 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 eşzamansızlık sorunlarını çözmek için tasarlanmıştır.

Yeniden adlandırılan alanlar

Accounts alt API'sindeki Kargo ayarları kaynağında aşağıdaki alanların adı değiştirildi:

Content API for Shopping Kargo ayarları kaynağı 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 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 nakliye sırasında geçirdiği minimum iş günü sayısı. Örneğin, 0 değeri aynı gün teslimat, 1 değeri ise ertesi gün teslimat anlamına gelir.
service.deliveryTime.maxTransitTimeInDays services.deliveryTime.maxTransitDays Bir siparişin nakliye sırasında geçirdiği maksimum iş günü sayısı.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Siparişin gönderilmeden önce harcanan minimum iş günü sayısı.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Bir siparişin kargolanmasından önce harcanan 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 Kargo ücretlerinin listesi.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Aynı minimum sipariş değerini paylaşan mağaza kodu kümelerinin listesi.

Kaldırılan yöntemler

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

Kaldırılan alanlar

Merchant API'de, Content API for Shopping'deki aşağıdaki alanlar kaldı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

    • Rate_group
      • single_value_alternative_list

Yöntemler

Aşağıda, Content API for Shopping ve kargo ayarları kaynağındaki yöntemlerin karşılaştırması verilmiştir:

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 data sources management
Sonraki
Migrate conversion sources management