Bölge oluşturma ve güncelleme

Merchant API'de, accounts.products.regionalInventories kaynağıyla ilgili hizmetler için hedef olarak coğrafi bölgeleri kullanabilirsiniz. Bölgeleri posta kodu grupları veya bazı ülkelerde önceden tanımlanmış coğrafi hedefler olarak tanımlayabilirsiniz. Daha fazla bilgi için Bölgeleri ayarlama başlıklı makaleyi inceleyin.

Bölgeleri oluşturmak ve güncellemek için aşağıdaki yöntemleri kullanabilirsiniz:

Bölgeyi alma

Merchant Center hesabınızda tanımlanan bir bölgeyi almak için accounts.regions.get yöntemini kullanın.

Aşağıda örnek bir istek verilmiştir:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions/234567

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

HTTP/1.1 200

{
  "name": "accounts/125222396/regions/234567",
  "displayName": "Canada",
  "postalCodeArea": {
    "regionCode": "CA",
    "postalCodes": [
      {
        "begin": "L6A"
      }
    ]
  }

Tüm bölgeleri listeleme

Merchant Center hesabınızdaki bölgeleri listelemek için accounts.regions.list yöntemini kullanın.

Aşağıda örnek bir istek verilmiştir:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/125222396/regions?pageSize=100

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

HTTP/1.1 200

{
  "regions": [
    {
      "name": "accounts/125222396/regions/234567",
      "displayName": "Canada",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "L6A"
          }
        ]
      },
      "regionalInventoryEligible": true,
      "shippingEligible": true
    },
    {
      "name": "accounts/125222396/regions/Inline region",
      "displayName": "Inline region",
      "postalCodeArea": {
        "regionCode": "CA",
        "postalCodes": [
          {
            "begin": "M7B"
          }
        ]
      },
      "regionalInventoryEligible": false,
      "shippingEligible": true
    },
  ]
}

Bölge ekleme

Merchant Center hesabınıza bölge tanımı eklemek için accounts.regions.create yöntemini kullanın. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Aşağıda örnek bir istek verilmiştir:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=987654

{
  "displayName": "TestRegion",
  "name": "987654",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98109"
      }
    ],
    "regionCode": "US"
  }
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
     "name": "accounts/102959835/regions/987654",
  "displayName": "TestRegion",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98109"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

AreaCode ile yeni bir bölge oluşturmak için:

Aşağıda örnek bir istek verilmiştir:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions?regionId=168888 HTTP/1.1

{
  "displayName": "WA_test",
  "name": "168888",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20101
    ]
  }
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "WA_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20101"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

Oluşturulan bölgenin displayName ve GeoTargetCriteriaIds değerlerini güncellemek için:

Aşağıda örnek bir istek verilmiştir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea HTTP/1.1

{
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      20100
    ]
  }
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

HTTP/1.1 200

{
  "name": "accounts/102959835/regions/168888",
  "displayName": "BR_test",
  "geotargetArea": {
    "geotargetCriteriaIds": [
      "20100"
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": false
}

Bölge güncelleme

Merchant Center hesabınızda bir bölge tanımını güncellemek için accounts.regions.patch yöntemini kullanın. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Aşağıda örnek bir istek verilmiştir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654?updateMask=displayName%2CpostalCodeArea HTTP/1.1

Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "displayName": "Test",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98108"
      }
    ],
    "regionCode": "US"
  }
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/102959835/regions/987654",
  "displayName": "Test",
  "postalCodeArea": {
    "regionCode": "US",
    "postalCodes": [
      {
        "begin": "98108"
      }
    ]
  },
  "regionalInventoryEligible": true,
  "shippingEligible": true
}

Bölge silme

Bölge tanımını Merchant Center hesabınızdan silmek için accounts.regions.delete yöntemini kullanın. Bu yöntemin yürütülmesi için yönetici erişimi gerekir.

Aşağıda örnek bir istek verilmiştir:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/102959835/regions/987654 HTTP/1.1

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

HTTP/1.1 200
{}

Toplu işlemler

Birden fazla bölgeyi yönetiyorsanız Merchant API, tek bir çağrıda 100'e kadar bölge oluşturmanıza, güncellemenize ve silmenize olanak tanıyan toplu uç noktalar sağlar. Daha fazla bilgi için Bölge toplu işleme özelliğini yönetme başlıklı makaleyi inceleyin.

Önceki
Manage Terms of Service
Sonraki
Manage region batching