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

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

পূর্বশর্ত

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

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

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

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

  • সহজ সেট-আপ: টেস্ট অ্যাকাউন্ট সেট-আপ করা একটি সহজ প্রসেস যা আপনাকে দ্রুত ফিচার ও ইন্টিগ্রেশন টেস্ট করা শুরু করতে দেয়।
  • ডেটা ইন্টিগ্রিটি ও নিরাপত্তা: প্রোডাকশন ডেটা সুরক্ষিত থাকে এবং প্রোডাকশন অ্যাকাউন্টে নীতি লঙ্ঘনের ঝুঁকি থাকে না।
  • টেস্টিংয়ের দক্ষতা: আপনি বিভিন্ন ধরনের পরিস্থিতি ও এজ কেস টেস্ট করতে পারবেন এবং এর জন্য আপনাকে টেস্টিংয়ের উদ্দেশ্যে সমান্তরাল প্রোডাকশন অ্যাকাউন্ট বজায় রাখার বোঝা বহন করতে হবে না।
  • অফার অবিলম্বে যাচাই করা: অফার যোগ করার বিষয়টি দ্রুত পরীক্ষা করার জন্য, হোমপেজ দাবি করা ও টেস্ট অ্যাকাউন্টের যাচাইকরণ থেকে অটোমেটিক ছাড়ের সুবিধা নিন। টেস্ট অ্যাকাউন্টের জন্য অফার ডিফল্ট হিসেবে অনুমোদিত হয়।
  • বাস্তবসম্মত সিমুলেশন: প্রোডাক্ট আপলোড ও ইনভেনটরি ম্যানেজমেন্টের মতো গুরুত্বপূর্ণ কার্যকারিতার জন্য এনভায়রনমেন্ট প্রোডাকশন আচরণকে মিরর করে, যার ফলে টেস্টের ফলাফল নির্ভরযোগ্য হয়।
  • আরও সহজে API মাইগ্রেশন: টেস্ট অ্যাকাউন্টগুলি Content 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-এর মাধ্যমে সরাসরি উন্নত টেস্ট অ্যাকাউন্ট তৈরি করতে পারবেন না। প্রথমে, একটি স্বতন্ত্র টেস্ট অ্যাকাউন্ট তৈরি করুন এবং তারপরে এটিকে একটি উন্নত অ্যাকাউন্টে রূপান্তর করুন।
  • কোনও সর্বজনীন পরিষেবা নয়: টেস্ট অ্যাকাউন্টে জমা দেওয়া ডেটা কখনও কোনও Google প্ল্যাটফর্মে প্রকাশ করা হবে না, যেমন Search বা Shopping বিজ্ঞাপন।
  • সীমাবদ্ধ এন্ডপয়েন্ট: আপনি নির্দিষ্ট কিছু ফিচার ব্যবহার করার সময় টেস্ট অ্যাকাউন্ট ব্যবহার করতে পারবেন না, যেমন:
  • লিঙ্ক করার ক্ষেত্রে বিধিনিষেধ: আপনি অন্যান্য Google Ads বা Google Business Profile অ্যাকাউন্টের সাথে টেস্ট অ্যাকাউন্ট লিঙ্ক করতে পারবেন না।
  • টেস্ট অ্যাকাউন্টের জন্য রেজিস্ট্রেশন করা যাবে না: আপনি টেস্ট অ্যাকাউন্টের জন্য রেজিস্ট্রেশন করতে পারবেন না।

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

টেস্ট অ্যাকাউন্ট ব্যবহার করার সময় কিছু পেশাদার পদ্ধতি অনুসরণ করার জন্য আমরা সাজেস্ট করি:

  • স্যান্ডবক্স-ফার্স্ট ডেভেলপমেন্ট: প্রোডাকশন এনভায়রনমেন্টে প্রয়োগ করার আগে নতুন ইন্টিগ্রেশন ফিচার সবসময় টেস্ট অ্যাকাউন্টে যাচাই করুন।
  • অটোমেটেড ইন্টিগ্রেশন টেস্টিং: অটোমেটেড রিগ্রেশন টেস্ট চালানোর জন্য স্টেবল এনভায়রনমেন্ট হিসেবে টেস্ট অ্যাকাউন্ট ব্যবহার করুন।
  • টেস্ট অ্যাকাউন্টের নামকরণ: প্রতিটি টেস্ট অ্যাকাউন্টের উদ্দেশ্য বোঝাতে account_name ব্যবহার করুন, যেমন "মাইগ্রেশন টেস্টিং" বা "ইন্টিগ্রেশন টেস্ট অ্যাকাউন্ট"।
পূর্ববর্তী
Access your account
পরবর্তী
Merchant API MCP Access Service