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:

• Get
• List
• Create
• Patch
• Delete

Bölge 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?key=[YOUR_API_KEY]

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&key=[YOUR_API_KEY]

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öntemi yürütmek 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&key=[YOUR_API_KEY]

{
  "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&key=[YOUR_API_KEY] 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&key=[YOUR_API_KEY] 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öntemi yürütmek 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&key=[YOUR_API_KEY] 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öntemi yürütmek 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?key=[YOUR_API_KEY] 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.