Поддержка Merchant API v1beta будет прекращена и отключена 28 февраля 2026 года. Инструкции по переходу на последнюю стабильную версию см. в разделе «Миграция с v1beta на v1» .

Эта страница переведена с помощью Cloud Translation API.

Обзор под-API рекламных акций,Обзор под-API рекламных акций

Используйте рекламные акции, чтобы демонстрировать специальные предложения на товары, которые вы продаете в Google. Рекламные акции отображаются на различных ресурсах Google, включая Google Поиск, Google Покупки и Chrome. Для одобрения рекламной акции необходимо соответствовать определенным критериям. Дополнительную информацию см. в разделе «Критерии рекламных акций» .

Когда вы добавляете акцию к своим товарам, покупатели видят специальную ссылку на предложение. Например, «скидка 15%» или «бесплатная доставка». Ссылки на предложения могут повысить привлекательность ваших товаров и побудить покупателей совершить покупку. Все акции применяются при оформлении заказа или в точке продажи.

Для получения более подробной информации см. раздел «Основы продвижения» .

Предварительные требования

Для показа ваших рекламных акций Google требует предоставления конкретной информации о вашем бизнесе и товарах. Вам необходимо иметь следующее:

Активный товарный фид в Google Merchant Center .
Активный фид рекламных акций в Google Merchant Center .
Аккаунт Google Ads для рекламных кампаний в сфере товаров .

Кроме того, вам необходимо зарегистрировать свой аккаунт в Merchant Center в программе рекламных акций. Если вы не уверены, зарегистрированы ли вы уже, проверьте это в Merchant Center .

Если вы еще не зарегистрированы, заполните форму заявки . Команда по продвижению сообщит вам, когда вы будете готовы начать внедрение.

Для получения более подробной информации см. Критерии и правила участия .

Создайте источник данных

Для создания источника данных для рекламных акций можно использовать метод accounts.dataSources.create . Если уже существует источник данных для рекламных акций, используйте метод accounts.dataSources.list для получения всех источников данных. Затем вы можете использовать поле name источника данных для создания рекламных акций .

В следующем запросе показано, как создать источник данных для добавления рекламных акций:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "promotionDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "targetCountry": "{TARGET_COUNTRY}"
  }
}

Замените следующее:

{ACCOUNT_ID} : Уникальный идентификатор вашей учетной записи, отображаемый в пользовательском интерфейсе Merchant Center.
{DISPLAY_NAME} : Отображаемое имя источника данных.
{CONTENT_LANGUAGE} : Двухбуквенный код языка ISO 639-1 для продуктов в источнике данных.
{TARGET_COUNTRY} : Код территории CLDR целевой страны, где вы хотите, чтобы рекламные акции отображались.

После успешного выполнения запроса вы увидите следующий ответ, содержащий подробную информацию о недавно созданном источнике данных о рекламных акциях:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "promotionDataSource": {
    "targetCountry": "{TARGET_COUNTRY}",
    "contentLanguage": "{CONTENT_LANGUAGE}"
  },
  "input": "API"
}

Создавайте рекламные акции

Для создания или обновления акции можно использовать метод accounts.promotions.insert . Метод accounts.promotions.insert принимает на вход ресурс promotions и имя источника данных. В случае успеха он возвращает новую или обновленную акцию.

Для создания рекламной акции необходимо указать название источника данных . Также в запросе необходимо указать значения для следующих полей:

contentLanguage
redemptionChannel
promotionId
targetCountry
attributes.offerType
attributes.genericRedemptionCode
attributes.couponValueType
attributes.productApplicability
attributes.promotionEffectiveTimePeriod.endTime
attributes.promotionEffectiveTimePeriod.startTime
attributes.longTitle

Google проверяет и одобряет ваши рекламные материалы перед их распространением. Для получения дополнительной информации см. раздел «Процесс одобрения рекламных материалов» .

Мы рекомендуем вам ознакомиться с правилами размещения рекламных акций, чтобы убедиться, что создаваемые вами акции приносят пользу и соответствуют правилам размещения товарных объявлений.

Следующий запрос демонстрирует, как создать онлайн-акцию:

HTTP

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
"promotion": {
  "name": "{PROMOTION_NAME}",
  "promotionId": "{PROMOTION_ID}",
  "targetCountry": "{TARGET_COUNTRY}",
  "redemptionChannel": [
    "ONLINE"
  ],
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "attributes": {
    "promotionDisplayTimePeriod": {
      "endTime": "{PROMOTION_END_TIME}",
      "startTime": "{PROMOTION_START_TIME}"
    },
    "offerType": "{OFFER_TYPE}",
    "longTitle": "{LONG_TITLE}"
  }
},
"dataSource": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}"
}

cURL

  curl --request POST \
'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"dataSource":"{DATASOURCE_ID}","promotion":{"name":"accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}y","promotionId":"abc","contentLanguage":"en","targetCountry":"US","redemptionChannel":["ONLINE"]}}' \
--compressed

Информацию о правилах, применимых к настройке идентификатора акции, см. в разделе «Минимальные требования к атрибуту идентификатора акции» .

Допустимые значения для обязательного поля offerType — NO_CODE и GENERIC_CODE . Если вы не укажете одно из этих значений, запрос к API завершится ошибкой HTTP 400 [offer_type] validation/missing_required: Invalid or missing required attribute: offer_type . Аналогичное сообщение об ошибке возвращается, если вы не укажете ни одно из обязательных полей.

Если вы не укажете значение для поля attributes.genericRedemptionCode , запрос завершится ошибкой HTTP 400 [genericRedemptionCode] No redemption code provided .

Значения полей promotion.attributes.promotionDisplayTimePeriod.startTime и promotion.attributes.promotionDisplayTimePeriod.endTime должны быть в формате yyyy-mm-ddThh:mm:ssZ . Убедитесь, что вы заменили значения в этих полях датами из будущего времени.

Для получения более подробной информации см. спецификацию данных для рекламных акций .

Рекомендации по созданию рекламных акций см. в разделе «Рекомендации по проведению рекламных акций» .

Список атрибутов, связанных с акциями, см. в разделе «Добавление атрибутов структурированных данных» .

После успешного выполнения запроса на создание рекламной акции может потребоваться несколько минут, прежде чем акция станет доступна через API или отобразится в Центре продавцов.

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

Java

import com.google.api.core.ApiFuture;
import com.google.api.core.ApiFutureCallback;
import com.google.api.core.ApiFutures;
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.protobuf.Timestamp;
import com.google.shopping.merchant.promotions.v1.Attributes;
import com.google.shopping.merchant.promotions.v1.CouponValueType;
import com.google.shopping.merchant.promotions.v1.InsertPromotionRequest;
import com.google.shopping.merchant.promotions.v1.OfferType;
import com.google.shopping.merchant.promotions.v1.ProductApplicability;
import com.google.shopping.merchant.promotions.v1.Promotion;
import com.google.shopping.merchant.promotions.v1.PromotionsServiceClient;
import com.google.shopping.merchant.promotions.v1.PromotionsServiceSettings;
import com.google.shopping.merchant.promotions.v1.RedemptionChannel;
import com.google.shopping.type.CustomAttribute;
import com.google.shopping.type.Destination.DestinationEnum;
import com.google.type.Interval;
import java.util.ArrayList;
import java.util.List;
import java.util.Random;
import java.util.stream.Collectors;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to insert multiple promotions asynchronously. */
public class InsertPromotionsAsyncSample {

  private static String generateRandomString() {
    String characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
    Random random = new Random();
    StringBuilder sb = new StringBuilder(8);
    for (int i = 0; i < 8; i++) {
      sb.append(characters.charAt(random.nextInt(characters.length())));
    }
    return sb.toString();
  }

  private static Promotion createPromotion(String accountId) {
    String merchantPromotionId = generateRandomString();

    Attributes attributes =
        Attributes.newBuilder()
            .setProductApplicability(ProductApplicability.ALL_PRODUCTS)
            .setOfferType(OfferType.GENERIC_CODE)
            .setGenericRedemptionCode("ABCD1234")
            .setLongTitle("My promotion")
            .setCouponValueType(CouponValueType.PERCENT_OFF)
            .addPromotionDestinations(DestinationEnum.SHOPPING_ADS)
            .setPercentOff(10)
            // Note that promotions have a 6-month limit.
            // For more information, read here: https://support.google.com/merchants/answer/2906014
            // Also note that only promotions valid within the past 365 days are shown in the UI.
            .setPromotionEffectiveTimePeriod(
                Interval.newBuilder()
                    .setStartTime(Timestamp.newBuilder().setSeconds(1726842472))
                    .setEndTime(Timestamp.newBuilder().setSeconds(1726842473))
                    .build())
            .build();

    return Promotion.newBuilder()
        .setName(String.format("accounts/%s/merchantPromotions/%s", accountId, merchantPromotionId))
        .setPromotionId(merchantPromotionId)
        .setContentLanguage("fr")
        .setTargetCountry("CH")
        .addRedemptionChannel(RedemptionChannel.ONLINE)
        .setAttributes(attributes)
        // Custom attributes allow you to add additional information which is not available in
        // Attributes. For example, you might want to pilot experimental functionality.
        .addCustomAttributes(
            CustomAttribute.newBuilder()
                .setName("another example name")
                .setValue("another example value")
                .build())
        .build();
  }

  public static void asyncInsertPromotions(String accountId, String dataSourceId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    PromotionsServiceSettings merchantPromotionsServiceSettings =
        PromotionsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (PromotionsServiceClient merchantPromotionsServiceClient =
        PromotionsServiceClient.create(merchantPromotionsServiceSettings)) {

      // Arbitrarily creates five merchant promotions with random IDs.
      List<InsertPromotionRequest> requests = new ArrayList<>();
      for (int i = 0; i < 5; i++) {
        InsertPromotionRequest request =
            InsertPromotionRequest.newBuilder()
                .setParent(String.format("accounts/%s", accountId))
                .setPromotion(createPromotion(accountId))
                .setDataSource(String.format("accounts/%s/dataSources/%s", accountId, dataSourceId))
                .build();
        requests.add(request);
      }

      // Inserts the merchant promotions.
      List<ApiFuture<Promotion>> futures =
          requests.stream()
              .map(
                  request ->
                      merchantPromotionsServiceClient.insertPromotionCallable().futureCall(request))
              .collect(Collectors.toList());

      // Creates callback to handle the responses when all are ready.
      ApiFuture<List<Promotion>> responses = ApiFutures.allAsList(futures);
      ApiFutures.addCallback(
          responses,
          new ApiFutureCallback<List<Promotion>>() {
            @Override
            public void onSuccess(List<Promotion> results) {
              System.out.println("Inserted merchant promotions below:");
              System.out.println(results);
            }

            @Override
            public void onFailure(Throwable throwable) {
              System.out.println(throwable);
            }
          },
          MoreExecutors.directExecutor());
    } catch (Exception e) {
      System.out.println(e);
    }
  }


  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    asyncInsertPromotions(config.getAccountId().toString(), "<YOUR_DATA_SOURCE_ID>");
  }
}InsertPromotionsAsyncSample.java

Ниже приведены несколько примеров рекламных акций, которые вы можете использовать для начала работы.

Местная акция, распространяющаяся на все товары и все магазины.

Приведенный ниже пример запроса демонстрирует, как создать локальную акцию, применимую ко всем товарам в вашем аккаунте Merchant Center и ко всем магазинам, добавленным в связанный с ним аккаунт бизнес-профиля .

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
  "promotion": {
    "promotionId": "buy_2_get_10_off",
    "contentLanguage": "en",
    "targetCountry": "US",
    "redemptionChannel": [
      "IN_STORE"
    ],
    "attributes": {
      "longTitle": "Buy 2 and get 10$ OFF purchase",
      "productApplicability": "ALL_PRODUCTS",
      "offerType": "NO_CODE",
      "couponValueType": "BUY_M_GET_MONEY_OFF",
      "promotionDisplayTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "promotionEffectiveTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "moneyOffAmount": {
        "amountMicros": "1000000",
        "currencyCode": "USD"
      },
      "minimumPurchaseQuantity": 2,
      "storeApplicability": "ALL_STORES",
      "promotionUrl": "http://promotionnew4url.com/",
      "promotionDestinations": [
        "LOCAL_INVENTORY_ADS"
      ],
    }
  },
  "dataSource": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}"
}

Поле productApplicability является обязательным. Оно указывает, распространяется ли акция на все товары или только на определенные. Поддерживаемые значения: ALL_PRODUCTS и SPECIFIC_PRODUCTS . Для получения дополнительной информации см. раздел «Выбор товаров для акции» .

Поле couponValueType является обязательным. Оно указывает тип проводимой вами акции. Список поддерживаемых значений см. в разделе «Тип значения купона» . В зависимости от выбранного типа значения купона некоторые атрибуты могут быть обязательными .

Поле minimumPurchaseQuantity позволяет установить минимальное количество товара, необходимое для участия в акции. Дополнительную информацию см. в разделе «Минимальное количество товара для участия в акции» .

Аналогичным образом, вы можете использовать поле minimumPurchaseAmount для установки минимальной суммы покупки, необходимой для получения скидки. Дополнительную информацию см. в разделе «Минимальная сумма покупки» .

Для получения дополнительной информации о значениях, которые необходимо указать при создании локальной акции, см. раздел «Спецификации источников данных для локальных акций» .

Онлайн-акция, распространяющаяся на избранные товары при предъявлении промокода.

В приведенном ниже примере показано, как создать онлайн-акцию, которая распространяется на выбранные товары с использованием промокода.

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
 "promotion": {
   "promotionId": "25_pct_off",
   "contentLanguage": "en",
   "targetCountry": "US",
   "redemptionChannel": [
     "ONLINE"
   ],
   "attributes": {
     "longTitle": "10% off on selected items",
     "productApplicability": "SPECIFIC_PRODUCTS",
     "offerType": "GENERIC_CODE",
     "genericRedemptionCode": "SPRINGSALE",
     "couponValueType": "PERCENT_OFF",
     "promotionDisplayTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "promotionEffectiveTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "percentOff": 25,
     "promotionDestinations": [
       "FREE_LISTINGS"
     ],
     "itemIdInclusion": [
       "1499860100",
       "1499860101",
       "1499860102",
       "1499860103",
       "1499860104"
     ],
   }
 },
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/1000000573361824"
}

Посмотреть акции

Для просмотра акции используйте accounts.promotions.get . Этот GET запрос доступен только для чтения. Он требует указания вашего merchantId и ID акции. Метод GET возвращает соответствующий ресурс с акциями.

Например:

HTTP

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}

cURL

  curl \
   'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed

Замените следующее:

{ACCOUNT_ID} : Уникальный идентификатор вашей учетной записи в Merchant Center.
{PROMOTION_ID} : Уникальный идентификатор акции, которую вы хотите получить. Формат: {CHANNEL} ~ {CONTENT_LANGUAGE} ~ {TARGET_COUNTRY} ~ {PROMOTION_ID} .

Обратите внимание, что для получения информации о новой акции через API требуется несколько минут.

Посмотреть местную акцию

Следующий пример запроса извлекает локальную акцию с идентификатором in_store~en~US~buy_2_get_10_off .

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/in_store~en~US~buy_2_get_10_off

После успешного выполнения запроса вы увидите следующий ответ:

{
 "name": "accounts/{ACCOUNT_ID}/promotions/in_store~en~US~buy_2_get_10_off",
 "promotionId": "buy_2_get_10_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "IN_STORE"
 ],
 "attributes": {
   "longTitle": "Buy 2 and get 10$ OFF purchase",
   "productApplicability": "ALL_PRODUCTS",
   "offerType": "NO_CODE",
   "couponValueType": "BUY_M_GET_MONEY_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "moneyOffAmount": {
     "amountMicros": "1000000",
     "currencyCode": "USD"
   },
   "minimumPurchaseQuantity": 2,
   "storeApplicability": "ALL_STORES",
   "promotionUrl": "http://promotionnew4url.com/",
   "promotionDestinations": [
     "LOCAL_INVENTORY_ADS"
   ],
 }
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/1000000573361824"
}

В этом примере поле moneyOffAmount отображает размер скидки, предлагаемой в рамках акции. Для получения дополнительной информации см. раздел «Размер денежной скидки в рамках акции» .

В этом примере поле promotionUrl содержит ссылку на веб-сайт магазина, где покупатели могут найти дополнительную информацию об акции. Если поле promotionUrl не указано в рекламных объявлениях о наличии товаров на складе, возникнет ошибка.

Посмотреть онлайн-акцию

Следующий пример запроса извлекает онлайн-акцию с идентификатором online~en~US~25_pct_off .

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/online~en~US~25_pct_off
{
 "name": "accounts/{ACCOUNT_ID}/promotions/online~en~US~25_pct_off",
 "promotionId": "25_pct_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "ONLINE"
 ],
 "attributes": {
   "longTitle": "10% off on selected items",
   "productApplicability": "SPECIFIC_PRODUCTS",
   "offerType": "GENERIC_CODE",
   "genericRedemptionCode": "WINTERGIFT",
   "couponValueType": "PERCENT_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "percentOff": 25,
   "promotionDestinations": [
     "FREE_LISTINGS"
   ],
   "itemIdInclusion": [
     "1499860100",
     "1499860101",
     "1499860102",
     "1499860103",
     "1499860104"
   ],
 }
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/{dataSource}"
}

Поле itemIdInclusion используемое в этом примере, указывает товары, участвующие в акции. Для получения дополнительной информации см. раздел «Идентификатор товара для акции» .

Список рекламных акций

Для просмотра всех созданных рекламных акций можно использовать метод promotions.list .

Вот пример запроса:

HTTP

GET https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_ID}/promotions

cURL

  curl \
   'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed

В ответе содержится список всех акций в вашем аккаунте. Для каждой акции вы можете увидеть подробную информацию, такую как promotionId , redemptionChannel , dataSource , promotionStatus и многое другое.

Посмотреть статус акции

Чтобы узнать статус акции, см. атрибут promotionStatus , возвращаемый методами promotions.get или promotions.list .

Поле promotionStatus может принимать следующие значения:

IN_REVIEW : Акция все еще находится на рассмотрении.
REJECTED : Акция отклонена.
LIVE : Акция одобрена и активна.
STOPPED : Акция остановлена для данного аккаунта.
EXPIRED акции истек: акция больше не действует.
PENDING : Акция не остановлена, все отзывы одобрены, но дата начала действия отложена.
STATE_UNSPECIFIED : Неизвестное состояние продвижения.

Чтобы ознакомиться с процессом утверждения созданной вами рекламной акции, см. раздел «Процесс утверждения рекламных акций» .

Пример статуса продвижения

Приведенные ниже примеры демонстрируют разницу между успешными и неудачными запросами.

Отсутствует сопоставление продуктов.

В приведенном ниже ответе показана онлайн-реклама, отклоненная из-за отсутствия сопоставления товаров.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "REJECTED"
      }
    ],
    "itemLevelIssues": [
      {
        "code": "promotion_sku_unmapped",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unmapped",
        "detail": "This promotion couldn't be tested during review because it doesn't apply to any products that are currently in your Products feed",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "promotion_sku_additional_requirements",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Promotion conditions not allowed",
        "detail": "This promotion has additional requirements that are not allowed such as requiring customers to verify additional details like phone number or ID before showing the promotion details",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      }
    ]
  }

Для устранения неполадок, связанных с отклоненными рекламными акциями, и чтобы узнать, как избежать отклонений в будущем, см. раздел «Устранение проблем с отклоненными рекламными акциями» .

Если созданная вами рекламная кампания не будет одобрена, вы получите электронное письмо с указанием причины отказа и инструкциями по устранению проблем.

Программа продвижения по службе находится на стадии оценки.

В приведенном ниже тексте ответа отображается информация о рекламной акции, которая все еще находится на стадии рассмотрения.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "PENDING"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "PENDING"
      }
    ],
    "itemLevelIssues": []
  }

Утвержденная и действующая рекламная акция

В приведенном ниже ответе отображается рекламная акция, видимая покупателям.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "LIVE"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "LIVE"
 }  ],
    "itemLevelIssues": []
  }

Для получения более подробной информации см. раздел «Часто задаваемые вопросы о статусе продвижения» .

Удалить рекламные акции

Удалить акцию с помощью API невозможно. Для удаления акции вам потребуется получить доступ к пользовательскому интерфейсу Merchant Center. Дополнительную информацию см. в разделе «Редактирование акции или изменение статуса акции» .

Чтобы завершить существующую акцию, вы можете использовать метод accounts.promotions.insert для обновления поля attributes.promotionEffectiveTimePeriod.endTime , указав время в прошлом.

Узнать больше

Более подробную информацию можно найти в Справочном центре по рекламным акциям .
Для устранения распространенных проблем см. раздел «Устранение неполадок, связанных с под-API Promotions» .
Чтобы узнать о миграции с Content API for Shopping, см. раздел «Миграция управления акциями» .

Обзор под-API рекламных акций,Обзор под-API рекламных акций Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Предварительные требования

Создайте источник данных

Создавайте рекламные акции

HTTP

cURL

Java

Местная акция, распространяющаяся на все товары и все магазины.

Онлайн-акция, распространяющаяся на избранные товары при предъявлении промокода.

Посмотреть акции

HTTP

cURL

Посмотреть местную акцию

Посмотреть онлайн-акцию

Список рекламных акций

HTTP

cURL

Посмотреть статус акции

Пример статуса продвижения

Удалить рекламные акции

Узнать больше

Обзор под-API рекламных акций,Обзор под-API рекламных акций