Merchant API-তে টেস্ট অ্যাকাউন্ট

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

পূর্বশর্ত

আপনি টেস্ট অ্যাকাউন্ট তৈরি ও ব্যবহার করার আগে, নিম্নলিখিত প্রয়োজনীয়তা পূরণ করেছেন কিনা তা নিশ্চিত করুন:

  • Merchant Center অ্যাকাউন্ট: আপনার অবশ্যই একটি Merchant Center অ্যাকাউন্ট থাকতে হবে।
  • Merchant API অ্যাক্সেস: আপনাকে অবশ্যই Merchant API-এর রেজিস্টার করা ব্যবহারকারী হতে হবে।

টেস্ট অ্যাকাউন্টের সুবিধা

টেস্ট অ্যাকাউন্ট ব্যবহার করলে বেশ কিছু গুরুত্বপূর্ণ সুবিধা পাওয়া যায়:

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

কীভাবে টেস্ট অ্যাকাউন্ট তৈরি করতে হয়

Merchant API-তে নির্দিষ্ট কাস্টম পদ্ধতি ব্যবহার করে টেস্ট অ্যাকাউন্ট তৈরি করা হয়।

accounts.createTestAccount পদ্ধতি ব্যবহার করুন:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

নিম্নলিখিতগুলি পরিবর্তন করুন:

  • ACCOUNT_ID: আপনার Merchant Center আইডি।
  • ACCESS_TOKEN: API কল করার জন্য অনুমোদন টোকেন
  • TEST_ACCOUNT_NAME: টেস্ট অ্যাকাউন্টের নাম। আমরা অর্থপূর্ণ নাম ব্যবহার করার পরামর্শ দিই যা থেকে বোঝা যায় যে সেগুলি পরীক্ষার জন্য ব্যবহার করা হচ্ছে। যেমন, টেস্ট অ্যাকাউন্টের নামের মধ্যে test শব্দটি থাকতে পারে।

টেস্ট অ্যাকাউন্ট তৈরি করার সময় নিম্নলিখিত ফিল্ডগুলি পূরণ করতে হবে:

  • time_zone: অ্যাকাউন্টের রিপোর্টিং ও ডিসপ্লে টাইম জোন।
  • language_code: অ্যাকাউন্টের জন্য BCP-47 ভাষা কোড, যেমন en-US।

কল সফল হলে, একটি অ্যাকাউন্ট রিসোর্স রিটার্ন করে যার মধ্যে নতুন টেস্ট অ্যাকাউন্টের অনন্য accountId ও রিসোর্স নাম থাকে:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

নিম্নলিখিত কোড স্যাম্পেল থেকে কীভাবে একটি টেস্ট অ্যাকাউন্ট তৈরি করতে হয় তা জানতে পারবেন:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.Account;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.CreateTestAccountRequest;
import com.google.type.TimeZone;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 * This class demonstrates how to create a new Merchant Center test account.
 *
 * <p>For more information refer to:
 * https://developers.google.com/merchant/api/guides/accounts/test-accounts
 */
public class CreateTestAccountSample {

  // Method to create a test account.
  public static void createTestAccount(Config config, String newAccountName) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      // The test account to be created.
      Account account =
          Account.newBuilder()
              .setAccountName(newAccountName)
              .setTimeZone(TimeZone.newBuilder().setId("Europe/Zurich"))
              .setLanguageCode("en-US")
              .build();

      // Creates parent to identify where to insert the account.
      String parent = String.format("accounts/%s", config.getAccountId());

      // Create the request message.
      CreateTestAccountRequest request =
          CreateTestAccountRequest.newBuilder().setParent(parent).setAccount(account).build();

      System.out.println("Sending Create Test Account request:");
      Account response = accountsServiceClient.createTestAccount(request);

      System.out.println("Created Test Account below:");
      System.out.println(response);
    } catch (Exception e) {
      System.err.println("Error during test account creation:");
      e.printStackTrace();
    }
  }

  // Main method to run the sample.
  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // This is the name of the new test account to be created.
    String newAccountName = "MyNewTestShop";

    createTestAccount(config, newAccountName);
  }
}

cURL

curl -X POST \
"https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/:createTestAccount" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
 "account_name": "{TEST_ACCOUNT_NAME}",
 "time_zone": {
   "id": "America/Los_Angeles"
   },
 "language_code": "en-US"
}'

উন্নত টেস্ট অ্যাকাউন্ট ও সাব-অ্যাকাউন্ট

accounts.createTestAccount পদ্ধতি সবসময় একটি স্বতন্ত্র টেস্ট অ্যাকাউন্ট তৈরি করে। পরীক্ষা করার জন্য উন্নত অ্যাকাউন্ট হায়ারার্কি সেট-আপ করতে:

  1. accounts.createTestAccount ব্যবহার করে একটি স্বতন্ত্র টেস্ট অ্যাকাউন্ট তৈরি করুন।
  2. Merchant Center-এ সেই স্বতন্ত্র টেস্ট অ্যাকাউন্টকে উন্নত অ্যাকাউন্ট সেট-আপে কনভার্ট করুন সহায়তা কেন্দ্র নিবন্ধে দেওয়া নির্দেশাবলী অনুসরণ করে উন্নত অ্যাকাউন্টে কনভার্ট করুন।
  3. উন্নত টেস্ট অ্যাকাউন্টের অধীনে অতিরিক্ত টেস্ট সাব-অ্যাকাউন্ট তৈরি করতে কল করুন accounts.createAndConfigure এবং উন্নত টেস্ট অ্যাকাউন্টকে accountAggregation প্রোভাইডার হিসেবে উল্লেখ করুন। টেস্ট প্রদানকারী অ্যাকাউন্টের অধীনে তৈরি করা যেকোনও সাব-অ্যাকাউন্ট অটোমেটিক টেস্ট অ্যাকাউন্ট (testAccount: true) হিসেবে তৈরি হয়।

সীমাবদ্ধতা

টেস্ট অ্যাকাউন্ট ফাংশনাল ভ্যালিডেশনের জন্য ডিজাইন করা হয় এবং এতে নির্দিষ্ট বিধিনিষেধ থাকে:

  • টেস্ট অ্যাকাউন্টের সংখ্যা: আপনি প্রতিটি Google অ্যাকাউন্টের জন্য সর্বাধিক ৫টি টেস্ট অ্যাকাউন্ট তৈরি করতে পারবেন। Google অ্যাকাউন্ট পিছু Merchant Center অ্যাকাউন্টের ডিফল্ট সীমা অনুযায়ী টেস্ট অ্যাকাউন্ট গণনা করা হয়।
  • Merchant API কোটার সাথে ইন্টিগ্রেশন: API কোটার দৃষ্টিকোণ থেকে, Merchant API, টেস্ট অ্যাকাউন্টকে প্রোডাকশন অ্যাকাউন্ট হিসেবে বিবেচনা করে। প্রোডাকশন অ্যাকাউন্টের মতো টেস্ট অ্যাকাউন্টের উপরও একই কোটা প্রযোজ্য হয়। টেস্ট অ্যাকাউন্টের জন্য কোটা বাড়ানো সম্ভব নয়।
  • অ্যাকাউন্ট কনভার্সন ও উন্নত অ্যাকাউন্ট: আপনি কোনও সাধারণ (লাইভ) অ্যাকাউন্ট—সেটি স্বতন্ত্র বা উন্নত অ্যাকাউন্ট যাই হোক না কেন—সেটিকে টেস্ট অ্যাকাউন্টে কনভার্ট করতে পারবেন না অথবা টেস্ট অ্যাকাউন্টকে লাইভ অ্যাকাউন্টে কনভার্ট করতে পারবেন না। এছাড়াও, আপনি accounts.createTestAccount-এর মাধ্যমে সরাসরি উন্নত টেস্ট অ্যাকাউন্ট তৈরি করতে পারবেন না। প্রথমে, একটি স্বতন্ত্র টেস্ট অ্যাকাউন্ট তৈরি করুন এবং তারপরে এটিকে উন্নত অ্যাকাউন্টে কনভার্ট করুন।
  • সর্বজনীনভাবে পরিবেশন করা হয় না: টেস্ট অ্যাকাউন্টে জমা দেওয়া ডেটা কখনই Search বা Shopping বিজ্ঞাপনের মতো কোনও Google প্ল্যাটফর্মে প্রকাশ করা হয় না।
  • বিধিনিষেধযুক্ত এন্ডপয়েন্ট: আপনি নিম্নলিখিত নির্দিষ্ট ফিচার ব্যবহার করার সময় টেস্ট অ্যাকাউন্ট ব্যবহার করতে পারবেন না:
  • লিঙ্ক করা সংক্রান্ত বিধিনিষেধ: আপনি অন্যান্য Google Ads বা Google Business Profile অ্যাকাউন্টের সাথে টেস্ট অ্যাকাউন্ট লিঙ্ক করতে পারবেন না।
  • টেস্ট অ্যাকাউন্টের জন্য কোনও রেজিস্ট্রেশন নেই: আপনি টেস্ট অ্যাকাউন্টের জন্য রেজিস্ট্রেশন করতে পারবেন না।

পেশাদার পদ্ধতি

টেস্ট অ্যাকাউন্ট ব্যবহার করার সময় কিছু পেশাদার পদ্ধতি মেনে চললে ভালো হয়:

  • স্যান্ডবক্স-ফার্স্ট ডেভেলপমেন্ট: প্রোডাকশন এনভায়রনমেন্টে প্রয়োগ করার আগে টেস্ট অ্যাকাউন্টে নতুন ইন্টিগ্রেশন ফিচার সবসময় যাচাই করে নিন।
  • অটোমেটেড ইন্টিগ্রেশন টেস্টিং: অটোমেটেড রিগ্রেশন টেস্ট চালানোর জন্য টেস্ট অ্যাকাউন্টকে স্থিতিশীল এনভায়রনমেন্ট হিসেবে ব্যবহার করুন।
  • টেস্ট অ্যাকাউন্টের নাম: প্রতিটি টেস্ট অ্যাকাউন্টের উদ্দেশ্য সম্পর্কে ইঙ্গিত দিতে account_name ব্যবহার করুন, যেমন "মাইগ্রেশন টেস্টিং" বা "ইন্টিগ্রেশন টেস্ট অ্যাকাউন্ট"।