regions
hizmeti, hem regionalinventory
hem de shippingsettings
hizmetleriyle hedef olarak kullanabileceğiniz coğrafi bölgeler oluşturup yönetmenize olanak tanır. Bölgeleri, posta kodu koleksiyonları olarak veya bazı ülkelerde önceden tanımlanmış coğrafi hedefler kullanarak tanımlayabilirsiniz. Bu kılavuzda, her bir bölge türünün nasıl tanımlanacağı ve bölgesel fiyatlandırmayı geçersiz kılmanın nasıl oluşturulacağına dair örnekler sağlanmaktadır. Mevcut tüm yöntemler ve parametreler dahil olmak üzere regions
hizmeti hakkında ek bilgi için referans belgelerine bakın.
Bölge uygunluğu
Bir bölge oluşturduğunuzda, bölgeler hizmeti, bölgeyi diğer Content API hizmetleriyle kullanıp kullanamayacağınızı belirler. Başarılı bir regions.create
çağrısı için döndürülen yanıt nesnesi, regionalInventoryEligible
ve shippingEligible
olmak üzere iki boole alanı içerir. Bu alanlar, bölgeyi sırasıyla regionalinventory
ve shippingsettings
hizmetleriyle kullanıp kullanamayacağınızı gösterir.
regionalInventoryEligible
Bir bölgenin, regionalinventory
hizmetiyle kullanılmaya uygun olması için aşağıdaki ölçütleri karşılaması gerekir:
- Bölge oluştururken belirttiğiniz
regionId
, yalnızca rakamlardan oluşmalı ve en az 6 haneli olmalıdır. - Bölge, coğrafi alan ve online nüfus için minimum boyut koşullarını karşılamalıdır.
shippingEligible
Bir bölgenin, shippingsettings
hizmetiyle kullanılmaya uygun olması için aşağıdaki ölçütleri karşılaması gerekir:
- Bölge, posta kodları kullanılarak tanımlanmalıdır.
- Bölge,
shippingsettings
hizmeti tarafından desteklenen bir ülkenin parçası olmalıdır.
Numuneler
Aşağıda, Java'da yeni bir bölge oluşturmak için kullanabileceğiniz eksiksiz bir kod örneği verilmiştir:
// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package shopping.content.v2_1.samples.regions; import com.google.api.client.googleapis.json.GoogleJsonResponseException; import com.google.api.services.content.model.Region; import com.google.api.services.content.model.RegionPostalCodeArea; import com.google.api.services.content.model.RegionPostalCodeAreaPostalCodeRange; import java.io.IOException; import java.util.ArrayList; import java.util.List; import shopping.content.v2_1.samples.ContentSample; /** * Creates a region. The region created here can be used with the regional inventory service. * Regional availability and pricing lets you provide product availability and variable pricing * based on your business presence and the location of your customer base. Regional availability and * pricing is available for products advertised through Shopping ads on Google Search, and listed in * free listings on the Shopping tab. */ public class RegionCreateSample extends ContentSample { public RegionCreateSample(String[] args) throws IOException { super(args); } @Override public void execute() throws IOException { checkNonMCA(); // Creates a List of Postal Code Area Postal Code Ranges. // This allows you to flexibly define regions as combinations of postal code // ranges. Each postal code range in the list has its own start and end zip code. List<RegionPostalCodeAreaPostalCodeRange> postalCodeRanges = new ArrayList<RegionPostalCodeAreaPostalCodeRange>(); // Creates a new postal code range from two postal code values. // This range is equivalent to all postal codes in the USA state of New York (00501 - 14925) RegionPostalCodeAreaPostalCodeRange postalCodeRange = new RegionPostalCodeAreaPostalCodeRange().setBegin("00501").setEnd("14925"); // Adds the NY State postal code range into the list of postal code ranges that a postal // code area accepts. postalCodeRanges.add(postalCodeRange); // Creates Postal Code Area for the Region that will be inserted, using the NY State postal code // ranges, and the US CLDR territory/country code that the postal code ranges applies to. RegionPostalCodeArea postalCodeArea = new RegionPostalCodeArea().setPostalCodes(postalCodeRanges).setRegionCode("US"); // Creates a region with example values for displayName and postalCodeArea Region region = new Region().setDisplayName("NYState").setPostalCodeArea(postalCodeArea); // Tries to create the region, and catches any exceptions try { System.out.println("Creating region"); Region result = content .regions() .create(this.config.getMerchantId().longValue(), region) .setRegionId("12345678") // User-defined, numeric, minimum of 6 digits .execute(); System.out.println("Listing succesfully created region"); System.out.println(result); } catch (GoogleJsonResponseException e) { checkGoogleJsonResponseException(e); } } public static void main(String[] args) throws IOException { new RegionCreateSample(args).execute(); } }
Posta kodlarını kullanarak bölge oluşturma
Posta kodu koleksiyonu olarak tanımlanan bir bölge oluşturmak için regions.create
yöntemini kullanabilirsiniz. Aşağıdaki örnekte, bir posta kodu aralığı belirterek ABD'nin Arizona eyaleti için yeni bir bölge oluşturulur.
Bölgeyi oluşturmak için aşağıdaki URL ile bir POST
isteği gönderin ve gövde isteğinde bulunun:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/regions?regionId=456789
{
postalCodeArea: {
regionCode: "US",
postalCodes: [
{
begin: "850*",
end: "860*"
}
]
}
}
Merchant Center hesabı başına regions
ve shippingsettings
için 2 MB'lık kesin veri sınırı vardır. Gönderim ve bölge ayarları bir MCA'dan tüm alt hesaplarına dahili olarak kopyalanır. Bu nedenle, daha büyük MCA'lar için depolama alanı sınırınıza hızlıca ulaşabilirsiniz. Bu durumda geçici çözüm, regions
ve shippingsettings
özelliklerini satıcı kimliği düzeyinde yönetmektir. Bölge kotanızı 2 MB'lık sınırı aşacak şekilde artırmak mümkün değildir.
Coğrafi hedefleri kullanarak bölge oluşturma
Brezilya ve Rusya'daki bölgeler için, önceden tanımlanmış coğrafi alanlar olan coğrafi hedef koleksiyonu olarak tanımlanan bir bölge oluşturmak amacıyla regions.create
yöntemini de kullanabilirsiniz. Coğrafi hedef türlerine örnek olarak ülkeler, eyaletler, şehirler, mahalleler ve havaalanları verilebilir. Ancak regions
hizmeti şu anda Brezilya için yalnızca "Eyalet" türünü, Rusya için de "Bölge" türünü desteklemektedir. regions
hizmetiyle kullanılabilecek coğrafi hedefler de dahil olmak üzere tüm coğrafi hedef kimliklerinin csv dosyasını indirmek için Coğrafi hedefler bölümüne bakın. Aşağıdaki örnekte, üç Brezilya eyaletinin coğrafi hedef kimliklerini sağlayarak yeni bir bölge oluşturulur.
Bölgeyi oluşturmak için aşağıdaki URL'yi kullanarak bir POST
isteği gönderin ve gövde isteğinde bulunun:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/regions?regionId=123456
{
geoTargetAreas: {
geotargetCriteriaId: [20106, 20102, 20101] //Sao Paulo, Rio de Janeiro, Parana
}
}
Bölgesel fiyat geçersiz kılmaları oluşturmak için bölgeleri kullanın
Bir bölge oluşturduğunuzda regions
hizmeti, regionId
ve iki uygunluk durumu alanı içeren bir yanıt nesnesi döndürür. regionalInventoryEligible
değeri true
ise bölge için farklı fiyat ayarlayan bir geçersiz kılma oluşturmak için regionaliventory
hizmetini kullanabilirsiniz. Aşağıdaki örnekte, yukarıdaki örnekte oluşturulmuş, regionId
değeri "456789" olan posta koduna dayalı bölgeyi kullanarak bölgesel fiyatı geçersiz kılma özelliği oluşturulmaktadır.
Geçersiz kılmayı oluşturmak için aşağıdaki URL'yi ve istek gövdesini kullanarak bir POST
isteğinde bulunun:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/{productId}/regionalinventory
{
“regionId”: "456789"
“price”: {
value: “10”
currency: “USD”
},
“availability”: “in stock”
}