মার্চেন্ট এপিআই ব্যবহার করে পণ্যের পর্যালোচনা করুন, মার্চেন্ট এপিআই ব্যবহার করে পণ্যের পর্যালোচনা করুন

পণ্য পর্যালোচনা গ্রাহকদের জন্য কেনাকাটা অভিজ্ঞতা একটি গুরুত্বপূর্ণ অংশ. এই রেটিং এবং পর্যালোচনাগুলি গ্রাহকদের পণ্য গবেষণা এবং ক্রয়ের সিদ্ধান্তে সহায়তা করে। ইতিবাচক পণ্য পর্যালোচনাগুলি বিক্রেতার পণ্য পৃষ্ঠাগুলিতে আরও যোগ্য গ্রাহকদের চালিত করতে পারে। উৎসের মধ্যে রয়েছে বিক্রেতা, পর্যালোচনা সমষ্টিকারী, পর্যালোচনা সাইট এবং Google ব্যবহারকারীরা।

এই পৃষ্ঠাটি ব্যাখ্যা করে কিভাবে আপনি মার্চেন্ট API ব্যবহার করে পণ্য পর্যালোচনা পরিচালনা করতে পারেন।

পূর্বশর্ত

Google আপনাকে নির্দিষ্ট তথ্য প্রদান করতে হবে। আপনার অবশ্যই নিম্নলিখিতগুলি থাকতে হবে:

  • Google Merchant Center-এ একটি সক্রিয় পণ্য পর্যালোচনা ফিড।
  • আপনার অ্যাকাউন্ট অবশ্যই প্রোডাক্ট রেটিং প্রোগ্রামে নথিভুক্ত হতে হবে। আপনি ইতিমধ্যে নথিভুক্ত কিনা তা নিশ্চিত না হলে, বণিক কেন্দ্র দেখুন। আপনি যদি নথিভুক্ত না হন, পণ্য রেটিং প্রোগ্রামে নথিভুক্ত করার বিষয়ে আরও জানুন।
  • Merchant API ব্যবহার করে পণ্য পর্যালোচনা করতে, এই ফর্মটি ব্যবহার করে একটি অনুরোধ জমা দিন।

একটি ডেটা উত্স তৈরি করুন

একটি পণ্য পর্যালোচনা ফিড তৈরি করতে datasource.create API ব্যবহার করুন। যদি একটি বিদ্যমান পণ্য পর্যালোচনা ফিড উপলব্ধ থাকে, তাহলে accounts.dataSources.get আনতে accounts.dataSources.name ব্যবহার করুন। অনুরোধের ফর্মটি নিম্নরূপ:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources/{datasource}

উদাহরণ

উদাহরণটি একটি সাধারণ অনুরোধ এবং প্রতিক্রিয়া দেখায়।

অনুরোধ

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

প্রতিক্রিয়া

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

আরও তথ্যের জন্য, একটি পণ্য পর্যালোচনা ডেটা উৎস তৈরি করুন দেখুন।

পণ্য পর্যালোচনা তৈরি করুন

আপনি একটি পণ্য পর্যালোচনা তৈরি বা আপডেট করতে accounts.productreviews.insert পদ্ধতি ব্যবহার করতে পারেন। accounts.productreviews.insert পদ্ধতি একটি productreview রিসোর্স এবং একটি ডেটা সোর্স নাম ইনপুট হিসেবে নেয়। সফল হলে এটি নতুন বা আপডেট করা productreview প্রদান করে। একটি পণ্য পর্যালোচনা তৈরি করতে, আপনার একটি datasource.name থাকতে হবে।

অনুরোধের ফর্ম:

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

নিম্নলিখিত নমুনা অনুরোধটি ব্যাখ্যা করে কিভাবে আপনি একটি পণ্য পর্যালোচনা তৈরি করতে পারেন।

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

  productReviewId = 'my_product_review'
  productReviewAttributes {
    aggregatorName = 'aggregator_name'
    subclientName = 'subclient_name'
    publisherName = 'publisher_name'
    publisherFavicon = 'https://www.google.com/favicon.ico'
    reviewerId = 'reviewer_id'
    reviewerIsAnonymous = false
    reviewerUsername = 'reviewer_username'
    reviewLanguage = 'en'
    reviewCountry = 'US'
    reviewTime = '2024-04-01T00:00:00Z'
    title = 'Incredible product'
    content = 'This is an incredible product.'
    pros = ['pro1', 'pro2']
    cons = ['con1', 'con2']
    reviewLink = {
      type = 'SINGLETON'
      link = 'https://www.google.com'
    }
    reviewerImageLink = 'https://www.google.com/reviewer.png'
    minRating = 1
    maxRating = 10
    rating = 8.5
    productName = 'product_name'
    productLink = 'https://www.google.com/product'
    asins = ['asin1', 'asin2']
    gtins = ['gtin1', 'gtin2']
    mpns = ['mpn1', 'mpn2']
    skus = ['sku1', 'sku2']
    brands = ['brand1', 'brand2']
    isSpam = false
    collectionMethod = 'POST_FULFILLMENT'
    transactionId = 'transaction_id'
  }

পণ্য পর্যালোচনা তৈরির পরে, পর্যালোচনাটি প্রচার হতে কয়েক মিনিট সময় লাগতে পারে।

এখানে একটি নমুনা রয়েছে যা আপনি অ্যাসিঙ্ক্রোনাসভাবে একাধিক পণ্য পর্যালোচনা সন্নিবেশ করতে ব্যবহার করতে পারেন:

জাভা 

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.ListProductReviewsRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient.ListProductReviewsPagedResponse;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to list all the product reviews in a given account. */
public class ListProductReviewsSample {

  public static void listProductReviews(String accountId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      ListProductReviewsRequest request =
          ListProductReviewsRequest.newBuilder()
              .setParent(String.format("accounts/%s", accountId))
              .build();

      System.out.println("Sending list product reviews request:");
      ListProductReviewsPagedResponse response =
          productReviewsServiceClient.listProductReviews(request);

      int count = 0;

      // Iterates over all rows in all pages and prints all product reviews.
      for (ProductReview element : response.iterateAll()) {
        System.out.println(element);
        count++;
      }
      System.out.print("The following count of elements were returned: ");
      System.out.println(count);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

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

একটি পণ্য পর্যালোচনা পুনরুদ্ধার করুন

একটি পণ্য পর্যালোচনা দেখতে, accounts.productreviews.get ব্যবহার করুন। এটি শুধুমাত্র পঠনযোগ্য। নাম ক্ষেত্রের অংশ হিসাবে এটির জন্য আপনার accountId আইডি এবং পণ্য পর্যালোচনার আইডি প্রয়োজন৷ GET পদ্ধতি সংশ্লিষ্ট পণ্য পর্যালোচনা সংস্থান প্রদান করে।

GET https://merchantapi.googleapis.com/reviews/v1/{name=accounts/{ACCOUNT_ID}/productReviews/*}

এখানে একটি নমুনা রয়েছে যা আপনি একটি পণ্য পর্যালোচনা পুনরুদ্ধার করতে ব্যবহার করতে পারেন:

জাভা 

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.GetProductReviewRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to get a product review. */
public class GetProductReviewSample {

  public static void getProductReview(String accountId, String productReviewId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      GetProductReviewRequest request =
          GetProductReviewRequest.newBuilder()
              .setName(String.format("accounts/%s/productReviews/%s", accountId, productReviewId))
              .build();

      System.out.println("Sending get product review request:");
      ProductReview response = productReviewsServiceClient.getProductReview(request);
      System.out.println("Product review retrieved successfully:");
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String productReviewId = "YOUR_PRODUCT_REVIEW_ID";
    getProductReview(config.getAccountId().toString(), productReviewId);
  }
}
GetProductReviewSample.java

পণ্য পর্যালোচনা তালিকা

আপনি সমস্ত তৈরি পণ্য পর্যালোচনা দেখতে productreviews.list পদ্ধতি ব্যবহার করতে পারেন।

GET https://merchantapi.googleapis.com/reviews/v1/{parent=accounts/{ACCOUNT_ID}}/productReviews

এখানে একটি নমুনা রয়েছে যা আপনি একটি পণ্যের জন্য সমস্ত পর্যালোচনা তালিকা করতে ব্যবহার করতে পারেন:

জাভা 

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.ListProductReviewsRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient.ListProductReviewsPagedResponse;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to list all the product reviews in a given account. */
public class ListProductReviewsSample {

  public static void listProductReviews(String accountId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      ListProductReviewsRequest request =
          ListProductReviewsRequest.newBuilder()
              .setParent(String.format("accounts/%s", accountId))
              .build();

      System.out.println("Sending list product reviews request:");
      ListProductReviewsPagedResponse response =
          productReviewsServiceClient.listProductReviews(request);

      int count = 0;

      // Iterates over all rows in all pages and prints all product reviews.
      for (ProductReview element : response.iterateAll()) {
        System.out.println(element);
        count++;
      }
      System.out.print("The following count of elements were returned: ");
      System.out.println(count);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

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

পণ্য পর্যালোচনা মুছুন

একটি পণ্য পর্যালোচনা মুছে ফেলতে, accounts.productreviews.delete ব্যবহার করুন। GET পদ্ধতির অনুরূপ, এই পদ্ধতিতে তৈরির সময় ফেরত দেওয়া পণ্য পর্যালোচনার নাম ক্ষেত্র প্রয়োজন। 

DELETE https://merchantapi.googleapis.com/reviews/v1/{name=accounts/{ACCOUNT_ID}/productReviews/*}

এখানে একটি নমুনা রয়েছে যা আপনি একটি পণ্য পর্যালোচনা মুছতে ব্যবহার করতে পারেন:

জাভা 

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.DeleteProductReviewRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to delete a product review. */
public class DeleteProductReviewSample {

  public static void deleteProductReview(String accountId, String productReviewId)
      throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      DeleteProductReviewRequest request =
          DeleteProductReviewRequest.newBuilder()
              .setName(String.format("accounts/%s/productReviews/%s", accountId, productReviewId))
              .build();

      System.out.println("Sending delete product review request:");
      productReviewsServiceClient.deleteProductReview(request);
      System.out.println("Product review deleted successfully");
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String productReviewId = "YOUR_PRODUCT_REVIEW_ID";
    deleteProductReview(config.getAccountId().toString(), productReviewId);
  }
}
DeleteProductReviewSample.java

পণ্য পর্যালোচনা অবস্থা

প্রোডাক্ট রিভিউ রিসোর্সে অন্যান্য API-এর মতো স্ট্যাটাস থাকে, যা রিসোর্সের একটি অবিচ্ছেদ্য অংশ এবং একই সমস্যা ও গন্তব্য কাঠামো অনুসরণ করে।