Sprawdzanie sprzedawców korzystających z interfejsu Merchant API

Opinie o sprzedawcy pomagają użytkownikom znajdować firmy, które oferują klientom obsługę o wysokiej jakości, co pomaga budować zaufanie i umożliwia podejmowanie trafniejszych decyzji zakupowych. Oznacza to, że oceny sklepu mogą pomóc firmom zwiększać skuteczność reklam i bezpłatnych wyników wyszukiwania oraz przyciągać więcej zainteresowanych klientów na ich strony docelowe.

Z tego artykułu dowiesz się, jak zarządzać opiniami o sprzedawcy za pomocą interfejsu Merchant API.

Wymagania wstępne

Google wymaga podania określonych informacji. Musisz mieć:

  • aktywne źródło danych z opiniami o sprzedawcy w Google Merchant Center;
  • Twoje konto musi być zarejestrowane w programie ocen sklepu. Jeśli nie masz pewności, czy jesteś już zarejestrowany(-a), sprawdź to w Merchant Center. Jeśli nie jesteś zarejestrowany(-a), prześlij formularz prośby.

Tworzenie źródła danych

Aby utworzyć plik danych opinii o sprzedawcach, użyj metody accounts.dataSources.create. Jeśli dostępny jest plik danych z opiniami o sprzedawcy, użyj metody accounts.dataSources.get, aby pobrać pole dataSource.name.

Żądanie ma następującą formę:

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

Przykład

Przykład pokazuje typowe żądanie i odpowiedź.

Wyślij prośbę

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

Odpowiedź

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

Więcej informacji znajdziesz w artykule Tworzenie źródła danych o opiniach o produktach.

Tworzenie opinii o sprzedawcy

Do tworzenia i aktualizowania opinii o sprzedawcy możesz użyć metody accounts.merchantReviews.insert. Metoda accounts.merchantReviews.insert przyjmuje jako dane wejściowe zasób merchantreview i nazwę źródła danych. Jeśli operacja się powiedzie, zwraca nową lub zaktualizowaną opinię o sprzedawcy. Aby utworzyć opinię o sprzedawcy, musisz datasource.name.

Forma żądania:

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

Zapoznaj się z przykładową opinią o sprzedawcy.

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'
  }

Po utworzeniu opinii o sprzedawcy może minąć kilka minut, zanim zostanie ona zastosowana.

Wyświetlanie opinii o sprzedawcy

Aby wyświetlić opinię o sprzedawcy, użyj właściwości accounts.merchantReviews.get. To pole jest tylko do odczytu. Wymaga podania merchantId i identyfikatora opinii o sprzedawcy w polu nazwy. Metoda get zwraca odpowiedni zasób opinii o sprzedawcy.

Na przykład:

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

Aby pobrać pojedynczy produkt z danego konta Merchant Center, możesz użyć metody google.shopping.merchant.accounts.v1.GetProductRequest, jak pokazano w poniższym przykładzie.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
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 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 {

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

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    // 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 product = "accounts/{datasource}/products/{productId}";

    getProduct(config, product);
  }
}
GetProductSample.java

Wyświetlanie opinii o sprzedawcy

Możesz użyć metody accounts.merchantReviews.list , aby wyświetlić wszystkie utworzone opinie o sprzedawcach.

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

Usuwanie opinii o sprzedawcy

Aby usunąć opinię o sprzedawcy, kliknij accounts.merchantReviews.delete. Podobnie jak w przypadku metody accounts.merchantReviews.get, ta metoda wymaga pola name opinii o sprzedawcy zwróconego podczas tworzenia.

Na przykład:

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

Stan opinii o sprzedawcy

Zasób opinii o sprzedawcy zawiera stan podobny do innych interfejsów API, który jest integralną częścią zasobu i ma taką samą strukturę jak problem i miejsce docelowe.