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.

Örnek bir istek:

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 listele

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

Örnek bir istek:

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.

Örnek bir istek:

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:

Örnek bir istek:

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ölge için displayName ve GeoTargetCriteriaIds değerlerini güncellemek üzere:

Örnek bir istek:

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ızdaki 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.

Örnek bir istek:

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.

Örnek bir istek:

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