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.
Na tej stronie znajdziesz informacje o tym, jak zarządzać opiniami sprzedawców za pomocą interfejsu Merchant API.
Wymagania wstępne
Google potrzebuje od Ciebie określonych informacji. Musisz mieć:
- aktywne źródło danych opinii sprzedawcy w Google Merchant Center;
- Twoje konto musi być zarejestrowane w programie oceny sklepów. Jeśli nie masz pewności, czy jesteś już zarejestrowany, sprawdź Merchant Center. Jeśli nie jesteś zarejestrowany, prześlij formularz prośby.
Tworzenie źródła danych
Aby utworzyć plik danych z opiniami sprzedawcy, użyj metody accounts.dataSources.create. Jeśli jest dostępny dotychczasowy plik danych opinii sprzedawcy, użyj wywołania accounts.dataSources.get, aby pobrać pole dataSource.name.
Prośba ma następującą formę:
POST https://merchantapi.googleapis.com/datasources/v1beta/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/v1beta/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 Omówienie źródeł danych Merchant Center w interfejsie API.
Tworzenie opinii o sprzedawcy
Aby utworzyć lub zaktualizować opinię 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. W przypadku powodzenia zwraca nową lub zaktualizowaną opinię sprzedawcy. Aby utworzyć opinię o sprzedawcy, musisz datasource.name.
Formularz prośby:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert
Zapoznaj się z przykładową opinią sprzedawcy.
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'
}
Po utworzeniu sprawdzenia sprzedawcy może minąć kilka minut, zanim zostanie ono zastosowane.
Wyświetlanie opinii o sprzedawcy
Aby wyświetlić opinię o sprzedawcy, kliknij accounts.merchantReviews.get.
Jest to pole tylko do odczytu. Wymaga to podania w polu nazwy Twojego merchantId i identyfikatora sprzedawcy. Metoda get zwraca odpowiedni zasób opinii sprzedawcy.
Na przykład:
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Aby pobrać pojedynczy produkt na danym koncie Merchant Center, możesz użyć metody google.shopping.merchant.accounts.v1beta.GetProductRequest, jak pokazano w tym przykładzie.
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.products.v1beta.GetProductRequest;
import com.google.shopping.merchant.products.v1beta.Product;
import com.google.shopping.merchant.products.v1beta.ProductsServiceClient;
import com.google.shopping.merchant.products.v1beta.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);
}
}
Wyświetlanie opinii o sprzedawcy
Aby wyświetlić wszystkie opinie o sprzedawcy, możesz użyć metody accounts.merchantReviews.list.
GET https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID} /merchantReviews
Usuwanie opinii o sprzedawcy
Aby usunąć opinię o sprzedawcy, kliknij accounts.merchantReviews.delete.
Podobnie jak metoda accounts.merchantReviews.get, ta metoda wymaga pola name opinii sprzedawcy zwróconej podczas tworzenia.
Na przykład:
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Stan opinii o sprzedawcy
Zasób weryfikacji sprzedawcy zawiera stan podobny do innych interfejsów API, który jest integralną częścią zasobu i podąża za tą samą strukturą problemów i miejsc docelowych.