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

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

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

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

Google требует, чтобы вы предоставили конкретную информацию. У вас должно быть следующее:

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

Примечание. Источник данных отзывов продавцов – это не то же самое, что источник данных отзывов о продуктах.

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

Используйте метод account.dataSources.create , чтобы создать фид отзывов о продавцах. Если доступен существующий фид отзывов продавцов, используйте account.dataSources.get , чтобы получить поле dataSource.name .

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

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

Пример

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

Запрос

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

Ответ

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

Дополнительную информацию см. в разделе Обзор API источников данных о продавцах .

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

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

Важно! Этот запрос перезаписывает весь ресурс обзора продавца, поэтому запрос должен включать все детали, чтобы избежать потери информации.

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

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

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

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

  merchantReviewId = 'my_own_review'
  attributes {
    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 и идентификатор отзыва продавца как часть поля имени. Метод get возвращает соответствующий ресурс обзора продавца.

Например:

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

Чтобы получить один продукт для определенного аккаунта Merchant Center, вы можете использовать метод google.shopping.merchant.accounts.v1beta.GetProductRequest , как показано в следующем примере.

Ява

  public static void getProduct(Config config, String product) 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}
      GetProductRequest request = GetProductRequest.newBuilder().setName(product).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);
    }
  }
GetProductSample.java

Получение списка отзывов о продавцах

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

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

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

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

Например:

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}

Статус проверки продавца

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