الحسابات التجريبية في Merchant API

توفّر ميزة "الحسابات التجريبية في Merchant API" مساحة آمنة ومعزولة لاختبار عمليات التكامل بدقة قبل نشرها في بيئة نشطة. باستخدام الحسابات التجريبية في البيئة المعزولة، يمكنك تجربة طلبات واجهة برمجة التطبيقات والتحقّق من صحة الرموز البرمجية وتحديد المشاكل المحتملة في مرحلة مبكرة من دورة التطوير، بدون التأثير في بيانات الإنتاج أو مقاطعة العمليات في الوقت الفعلي أو انتهاك سياسات Merchant Center عن غير قصد.

المتطلبات الأساسية

قبل أن تتمكّن من إنشاء حسابات تجريبية واستخدامها، تأكَّد من استيفاء المتطلبات التالية:

• حساب على Merchant Center: يجب أن يكون لديك حساب على Merchant Center.
• إذن الوصول إلى Merchant API: يجب أن تكون مستخدمًا مسجّلاً في Merchant API.

مزايا الحسابات التجريبية

يوفّر استخدام الحسابات التجريبية العديد من المزايا الرئيسية:

• إعداد بسيط: عملية إعداد الحساب التجريبي بسيطة وتتيح لك البدء بسرعة في اختبار ميزاتك وعمليات التكامل.
• سلامة البيانات وأمانها: تبقى بيانات الإنتاج محمية، ويتم التخلّص من خطر انتهاك السياسات في حسابات الإنتاج.
• كفاءة الاختبار: يمكنك اختبار مجموعة كبيرة من السيناريوهات المتنوّعة والحالات القصوى بدون عبء الاحتفاظ بحساب إنتاج موازٍ لأغراض الاختبار.
• التحقّق الفوري من صحة العروض: يمكنك الاستفادة من الإعفاء التلقائي من المطالبة بالصفحة الرئيسية والتحقّق منها للحسابات التجريبية من أجل اختبار إدراج العروض بسرعة. تتم الموافقة على العروض تلقائيًا للحسابات التجريبية.
• محاكاة واقعية: تعكس البيئة سلوك الإنتاج للوظائف الأساسية، مثل تحميل المنتجات وإدارة المستودع، ما يضمن موثوقية نتائج الاختبار.
• عمليات نقل بيانات أكثر سلاسة في واجهة برمجة التطبيقات: تسهّل الحسابات التجريبية عملية الانتقال بثقة وسلاسة من Content API إلى Merchant 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: رمز التفويض لتقديم طلب بيانات من واجهة برمجة التطبيقات
• 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"
  }

تعرض عيّنات التعليمات البرمجية التالية كيفية إنشاء حساب تجريبي:

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

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"
}'

القيود

تم تصميم الحسابات التجريبية للتحقّق من صحة الوظائف وتفرض قيودًا معيّنة:

• عدد الحسابات التجريبية: يمكنك إنشاء 5 حسابات تجريبية كحدّ أقصى لكل حساب على Google. تندرج الحسابات التجريبية ضمن الحدّ التلقائي لحسابات Merchant Center لكل حساب على Google.
• التكامل مع حصص Merchant API: من منظور حصص واجهة برمجة التطبيقات، تتعامل Merchant API مع الحسابات التجريبية على أنّها حسابات إنتاج. تخضع الحسابات التجريبية للحصص نفسها التي تخضع لها حسابات الإنتاج. لا يمكن زيادة الحصص للحسابات التجريبية.
• الحسابات بامتيازات متقدّمة: لا يمكنك إنشاء حسابات تجريبية بامتيازات متقدّمة أو تحويل حساب بامتيازات متقدّمة إلى حساب تجريبي.
• لا يتم عرض البيانات علنًا: لن يتم نشر البيانات التي يتم إرسالها إلى حساب تجريبي على أي منصة من منصات Google، مثل "إعلانات البحث" أو "إعلانات Shopping".
• نقاط نهاية محظورة: لا يمكنك استخدام الحسابات التجريبية عند استخدام ميزات معيّنة، مثل:
  • الخلاصات التلقائية
  • إدارة إعدادات الصفحة الرئيسية مثل المطالبة بالصفحة الرئيسية وإخلاء المسؤولية عنها.
  • الربط بـ "الملفات التجارية على Google"
  • "برنامج الشراكة في الخلاصات المحلية"
• قيود الربط: لا يمكنك ربط الحسابات التجريبية بحسابات أخرى على "إعلانات Google" أو "الملف التجاري على Google".
• لا يمكن التسجيل في الحسابات التجريبية: لا يمكنك إجراء عملية التسجيل للحسابات التجريبية.

أفضل الممارسات

ننصحك باتّباع بعض أفضل الممارسات عند استخدام الحسابات التجريبية:

• التطوير في البيئة المعزولة أولاً: يجب دائمًا التحقّق من صحة ميزات التكامل الجديدة في حساب تجريبي قبل تطبيقها على بيئة الإنتاج.
• اختبار التكامل الآلي: استخدِم الحسابات التجريبية كبيئات ثابتة لإجراء اختبارات الانحدار الآلية.
• تسمية الحساب التجريبي: استخدِم account_name للإشارة إلى الغرض من كل حساب تجريبي، مثل "اختبار نقل البيانات" أو "حساب تجريبي لعملية التكامل".