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

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:

  1. Merchant API kullanıcılarının aynı davranışa sahip olmaları için {name} alanına accounts/{accountId}/shippingSettings değerini eklemeleri gerekir.
  2. 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.
  3. WarehouseBasedDeliveryTime ayarlama yöntemi Content API for Shopping'den farklı şekilde Merchant API'ye uygulanır. Merchant API kullanıyorsanız depo bilgilerini shippingsettings.warehouses altında tanımlamanız gerekir. Daha sonra her gönderim hizmeti, warehouseBaseDeliveryTime altındaki depo adı üzerinden depoya referans verebilir.
  4. 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:

  1. Depolar: Envanteri depolayan ve yöneten bir sipariş karşılama deposu hakkında bilgi sağlar.
  2. Bağlılık programları: Merchant API kullanıcıları, bağlılık programı bilgilerini gönderim ayarlarına girebilir.
  3. 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
  • 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
    • |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ı aşağıda verilmiştir:

      Yöntem Content API for Shopping Satıcı API'sı
      customBatch Evet Hayır
      get Evet Evet
      update Evet Hayır
      insert Hayır Evet
      getSupportedCarrier Evet Hayır
      getSupportedHolidays Evet Hayır