Регионы

Сервис regions позволяет создавать и управлять географическими регионами, которые можно использовать в качестве целевых объектов как для сервисов regionalinventory , так и для сервисов shippingsettings . Вы можете определять регионы как наборы почтовых индексов или, в некоторых странах, используя предопределенные географические цели . В этом руководстве приведены примеры определения каждого типа региона, а также способы создания регионального переопределения цен. Для получения дополнительной информации о сервисе regions , включая все доступные методы и параметры, см. справочную документацию.

Региональные критерии отбора

При создании региона служба регионов определяет, можно ли использовать этот регион с другими службами Content API. Объект ответа, возвращаемый при успешном вызове regions.create , содержит два логических поля: regionalInventoryEligible и shippingEligible , которые указывают, можно ли использовать регион со службами regionalinventory и shippingsettings соответственно.

региональныйЗапасПодходящий

Для использования regionalinventory системы учета регион должен соответствовать следующим критериям:

  • regionId , который вы указываете при создании региона, должен содержать только цифры и не менее двух цифр.
  • Регион должен соответствовать минимальным требованиям по площади и численности онлайн-населения.

Доставка возможна

Для использования сервиса shippingsettings регион должен соответствовать следующим критериям:

  • Регион необходимо определить с помощью почтовых индексов.
  • Регион должен быть частью страны, поддерживаемой сервисом shippingsettings .

Образцы

Вот полный пример кода, который вы можете использовать для создания нового региона в Java:

// 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();
  }
}

Создайте регион, используя почтовые индексы.

Метод regions.create можно использовать для создания региона, определенного как набор почтовых индексов. В следующем примере создается новый регион для штата Аризона, США, путем указания диапазона почтовых индексов.

Для создания региона отправьте POST запрос со следующим URL-адресом и телом запроса:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/regions?regionId=456789

{
  postalCodeArea: {
    regionCode: "US",
    postalCodes: [
      {
        begin: "850*",
        end: "860*"
      }
    ]
   }
}

Существует жесткое ограничение в 2 МБ данных для regions и shippingsettings на один аккаунт Merchant Center. Настройки доставки и регионов копируются внутренне из одного аккаунта MCA во все его дочерние аккаунты, поэтому для больших аккаунтов MCA вы можете быстро достичь лимита хранилища. В этом случае обходным путем является управление regions и shippingsettings на уровне идентификатора продавца. Увеличить квоту на регионы сверх лимита в 2 МБ невозможно.

Создайте регион, используя геотаргеты.

Для регионов Бразилии и России вы также можете использовать метод regions.create для создания региона, определенного как набор геоцелей, которые представляют собой предопределенные географические области. Примеры типов геоцелей включают страны, штаты, города, районы и аэропорты. Однако служба regions поддерживает только тип «Штат» для Бразилии и тип «Регион» для России. Чтобы загрузить CSV-файл со всеми идентификаторами геоцелей, включая геоцели, которые можно использовать со службой regions , см. раздел «Геоцели» . В следующем примере создается новый регион путем указания идентификаторов геоцелей трех бразильских штатов.

Для создания региона отправьте POST запрос, используя следующий URL-адрес и тело запроса:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/regions?regionId=123456

{
  geoTargetAreas: {
    geotargetCriteriaId: [20106, 20102, 20101] //Sao Paulo, Rio de Janeiro, Parana
  }
}

Используйте регионы для создания региональных ценовых переопределений.

При создании региона служба regions возвращает объект ответа, который включает regionId и два поля статуса соответствия требованиям . Если значение regionalInventoryEligible равно true , вы можете использовать службу regionaliventory для создания переопределения, устанавливающего другую цену для региона. В следующем примере создается переопределение региональной цены с использованием региона на основе почтового индекса, созданного в предыдущем примере, с идентификатором regionId '456789'.

Для создания переопределения отправьте POST запрос, используя следующий URL-адрес и тело запроса:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/{productId}/regionalinventory

{
  'regionId': "456789"
  'price': {
    value: '10'
    currency: 'USD'
  },
  'availability': 'in stock'
}