이 페이지는 Cloud Translation API를 통해 번역되었습니다.

판매자 API를 사용하여 판매자 검토

판매자 리뷰는 사용자가 고품질의 고객 경험을 제공하는 비즈니스를 찾아 더 많은 정보에 입각한 구매 결정을 내릴 수 있도록 하고 신뢰 관계를 구축하는 데 도움이 됩니다. 따라서 매장 평점은 비즈니스가 광고 및 자연 검색 결과의 실적을 개선하고 구매할 가능성이 큰 고객을 방문 페이지로 유도하는 데 도움이 될 수 있습니다.

이 페이지에서는 Merchant API를 사용하여 판매자 리뷰를 관리하는 방법을 설명합니다.

기본 요건

Google에 특정 정보를 제공해야 합니다. 다음이 있어야 합니다.

Google 판매자 센터에 활성 판매자 리뷰 데이터 소스가 있습니다.
계정이 스토어 평점 프로그램에 등록되어 있어야 합니다. 이미 등록되었는지 확실하지 않은 경우 판매자 센터를 확인하세요. 등록되어 있지 않은 경우 요청 양식을 제출하세요.

데이터 소스 만들기

accounts.dataSources.create 메서드를 사용하여 판매자 리뷰 피드를 만듭니다. 기존 판매자 리뷰 피드를 사용할 수 있는 경우 accounts.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 및 판매자 리뷰의 ID가 필요합니다. get 메서드는 상응하는 판매자 리뷰 리소스를 반환합니다.

예를 들면 다음과 같습니다.

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

특정 판매자 센터 계정의 단일 제품을 검색하려면 다음 샘플과 같이 google.shopping.merchant.accounts.v1beta.GetProductRequest 메서드를 사용하면 됩니다.

자바

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);
  }
}GetProductSample.java

판매자 리뷰 목록

accounts.merchantReviews.list 메서드를 사용하여 생성된 모든 판매자 리뷰를 볼 수 있습니다.

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

판매자 리뷰 삭제

판매자 리뷰를 삭제하려면 accounts.merchantReviews.delete를 사용합니다. accounts.merchantReviews.get 메서드와 마찬가지로 이 메서드에는 생성 중에 반환된 판매자 리뷰의 이름 필드가 필요합니다.

예를 들면 다음과 같습니다.

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

판매자 검토 상태

판매자 검토 리소스에는 다른 API와 유사한 상태가 포함되어 있습니다. 이 상태는 리소스의 필수 부분이며 동일한 문제 및 대상 구조를 따릅니다.