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

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

Просматривайте продавцов с помощью Merchant API

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

На этой странице объясняется, как управлять отзывами продавцов с помощью Merchant API.

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

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

Активный источник данных об отзывах продавцов в Google Merchant Center.
Ваш аккаунт должен быть зарегистрирован в программе оценки магазинов . Если вы не уверены, зарегистрированы ли вы уже, проверьте Центр для продавцов. Если вы не зарегистрированы, отправьте форму запроса .

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

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

Форма запроса следующая:

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

Пример

В примере показаны типичные запрос и ответ.

Запрос

POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }

Ответ

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "merchantReviewDataSource": {},
  "input": "API"
}

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

Создать отзыв о продавце

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

Форма запроса:

POST https://merchantapi.googleapis.com/reviews/v1alpha/{parent=accounts/*/}merchantReviews:insert

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

POST https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

  merchantReviewId = 'my_own_review'
  merchantReviewAttributes {
    merchantId = 'merchant_id'
    merchantDisplayName = 'merchant_display_name'
    merchantLink = 'publisher_name'
    merchantRatingLink = 'https://www.google.com'
    minRating = 1
    maxRating = 10
    rating = 7.9
    title = 'Amazing Merchant'
    content = 'This is an incredible merchant'
    reviewerId = 'reviewer_id'
    reviewerUsername = 'reviewer_username'
    isAnonymous = false
    collectionMethod = 'AFTER_FULFILLMENT'
    reviewTime = '2024-04-01T00:00:00Z'
    reviewLanguage = 'en'
    reviewCountry = 'US'
  }

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

Посмотреть отзывы о продавце

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

Например:

GET https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}

Для получения информации об одном товаре для конкретной учетной записи Merchant Center можно использовать метод google.shopping.merchant.accounts.v1.GetProductRequest , как показано в следующем примере.

Java


import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.common.io.BaseEncoding;
import com.google.shopping.merchant.products.v1.GetProductRequest;
import com.google.shopping.merchant.products.v1.Product;
import com.google.shopping.merchant.products.v1.ProductsServiceClient;
import com.google.shopping.merchant.products.v1.ProductsServiceSettings;
import java.nio.charset.StandardCharsets;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to get a single product for a given Merchant Center account */
public class GetProductSample {

  // Base64Url encoder/decoder without padding
  private static final BaseEncoding BASE64URL_NOPADDING = BaseEncoding.base64Url().omitPadding();

  // Encodes a string to base64url without padding
  public static String encodeProductId(String productId) {
    return BASE64URL_NOPADDING.encode(productId.getBytes(StandardCharsets.UTF_8));
  }

  public static void getProduct(Config config, String accountId, String productId)
      throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    ProductsServiceSettings productsServiceSettings =
        ProductsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (ProductsServiceClient productsServiceClient =
        ProductsServiceClient.create(productsServiceSettings)) {

      // The name has the format: accounts/{account}/products/{productId}
      String name = "accounts/" + accountId + "/products/" + productId;

      // The name has the format: accounts/{account}/products/{productId}
      GetProductRequest request = GetProductRequest.newBuilder().setName(name).build();

      System.out.println("Sending get product request:");
      Product response = productsServiceClient.getProduct(request);

      System.out.println("Retrieved Product below");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String accountId = config.getAccountId().toString();

    // The name of the `product`, returned after a `Product.insert` request. We recommend
    // having stored this value in your database to use for all future requests.
    String productId = "en~US~sku123"; // Replace with your actual product ID

    // Uncomment the following line if the product name contains special characters (such as forward
    // slashes) and needs base64url encoding.
    // productId = encodeProductId(productId);

    getProduct(config, accountId, productId);
  }
}GetProductSample.java

Список отзывов о продавцах

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

GET https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews

Удалить отзывы о продавце

Для удаления отзыва о продавце используйте accounts.merchantReviews.delete . Аналогично методу accounts.merchantReviews.get , этот метод требует указания поля name отзыва о продавце, возвращенного при его создании.