Bölge oluşturma ve güncelleme

Bu kılavuz, accounts.products.regionalInventories kaynağıyla ilgili bir hedef hizmet olarak kullanabileceğiniz coğrafi bir bölgeyi temsil eder. Bölgeleri, posta kodları koleksiyonları olarak veya bazı ülkelerde önceden tanımlanmış coğrafi hedefleri kullanarak tanımlayabilirsiniz. Daha fazla bilgi için Bölgeleri ayarlama başlıklı makaleyi inceleyin.

Bölge oluşturmak ve güncellemek için aşağıdaki yöntemlerden birini 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/v1beta/accounts/125222396/regions/234567?key=[YOUR_API_KEY]

Başarılı bir aramadan 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/v1beta/accounts/125222396/regions?pageSize=100&key=[YOUR_API_KEY]

Başarılı bir aramadan 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 uygulanması için yönetici erişimi gerekir.

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

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions?regionId=987654&key=[YOUR_API_KEY]

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

Başarılı bir aramadan 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/v1beta/accounts/102959835/regions?regionId=168888&key=[YOUR_API_KEY] HTTP/1.1

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

Başarılı bir aramadan 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/v1beta/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea&key=[YOUR_API_KEY] HTTP/1.1

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

Başarılı bir aramadan 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 uygulanması için yönetici erişimi gerekir.

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

PATCH https://merchantapi.googleapis.com/accounts/v1beta/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 aramadan 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

Bir bölge tanımını Merchant Center hesabınızdan silmek için accounts.regions.delete yöntemini kullanın. Bu yöntemin uygulanması için yönetici erişimi gerekir.

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

DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions/987654?key=[YOUR_API_KEY] HTTP/1.1

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

HTTP/1.1 200
{}
Önceki
Manage Merchant Center email notifications