חשבונות בדיקה ב-Merchant API

התכונה "חשבונות בדיקה" ב-Merchant API מספקת מרחב בטוח ומבודד לבדיקה יסודית של שילובים לפני שפורסים אותם בסביבה פעילה. באמצעות חשבונות בדיקה בארגז חול, אתם יכולים להתנסות בקריאות ל-API, לאמת קוד ולזהות בעיות פוטנציאליות בשלב מוקדם של מחזור הפיתוח, בלי להשפיע על נתוני הייצור, לשבש פעולות בזמן אמת או להפר בטעות את המדיניות של Merchant Center.

דרישות מוקדמות

כדי ליצור חשבונות בדיקה ולהשתמש בהם, צריך לוודא שאתם עומדים בדרישות הבאות:

  • חשבון Merchant Center: צריך להיות לכם חשבון Merchant Center.
  • גישה ל-Merchant API: אתם צריכים להיות משתמשים רשומים ב-Merchant API.

היתרונות של חשבונות בדיקה

לשימוש בחשבונות בדיקה יש כמה יתרונות מרכזיים:

  • הגדרה פשוטה: הגדרת חשבון הבדיקה היא תהליך פשוט שמאפשר לכם להתחיל לבדוק במהירות את התכונות והשילובים שלכם.
  • תקינות נתונים ובטיחות: נתוני הייצור נשארים מוגנים, ואין סיכון להפרות מדיניות בחשבונות ייצור.
  • בדיקות יעילות: אתם יכולים לבדוק מגוון רחב של תרחישים ומקרי קצה בלי הנטל של תחזוקת חשבון ייצור מקביל למטרות בדיקה.
  • אימות מיידי של מוצרים: אתם יכולים לנצל את הפטור האוטומטי מתביעת בעלות על דף הבית ואימות שלו בחשבונות בדיקה כדי לבדוק במהירות הוספה של מוצרים. בחשבונות בדיקה, המבצעים מאושרים כברירת מחדל.
  • הדמיה מציאותית: הסביבה משקפת את ההתנהגות בסביבת הייצור של פונקציות קריטיות כמו העלאת מוצרים וניהול מלאי שטחי פרסום, וכך מבטיחה שתוצאות הבדיקה יהיו מהימנות.
  • מעבר חלק יותר בין ממשקי API: חשבונות בדיקה מאפשרים מעבר חלק ובטוח למי שעוברים מ-Content API ל-Merchant API או מגרסת API אחת לאחרת, כי הם מאפשרים לבצע אימות במקביל.

איך יוצרים חשבונות בדיקה

חשבונות בדיקה נוצרים באמצעות שיטה מותאמת אישית ספציפית ב-Merchant API.

משתמשים ב-method‏ 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.

אם הקריאה תצליח, יוחזר משאב Account שכולל את המזהה הייחודי 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).

מגבלות

חשבונות בדיקה מיועדים לאימות פונקציונלי, ויש להם מגבלות ספציפיות:

  • מספר חשבונות הבדיקה: אפשר ליצור עד 5 חשבונות בדיקה לכל חשבון Google. חשבונות בדיקה נכללים במגבלת ברירת המחדל של חשבונות Merchant Center לכל חשבון Google.
  • שילוב עם מכסות Merchant API: מבחינת מכסות ה-API,‏ Merchant API מתייחס לחשבונות בדיקה כמו לחשבונות פעילים. חשבונות בדיקה כפופים לאותן מכסות כמו חשבונות ייצור. אי אפשר להגדיל את המכסות בחשבונות בדיקה.
  • המרת חשבון וחשבונות מתקדמים: אי אפשר להמיר חשבון רגיל (פעיל) – בין אם הוא חשבון עצמאי או חשבון מתקדם – לחשבון בדיקה, או להמיר חשבון בדיקה לחשבון פעיל. בנוסף, אי אפשר ליצור ישירות חשבון בדיקה מתקדם באמצעות accounts.createTestAccount. קודם יוצרים חשבון בדיקה עצמאי ואז ממירים אותו לחשבון מתקדם.
  • אין הצגה לציבור: נתונים שנשלחים לחשבון בדיקה לא יפורסמו אף פעם באף פלטפורמה של Google, כמו חיפוש Google או מודעות שופינג.
  • נקודות קצה מוגבלות: אי אפשר להשתמש בחשבונות בדיקה כשמשתמשים בתכונות מסוימות, כמו:
  • הגבלות על קישור: אי אפשר לקשר חשבונות בדיקה לחשבונות אחרים ב-Google Ads או בפרופיל העסק ב-Google.
  • אין רישום לחשבונות בדיקה: אי אפשר לבצע רישום לחשבונות בדיקה.

שיטות מומלצות

מומלץ לפעול לפי כמה שיטות מומלצות כשמשתמשים בחשבונות בדיקה:

  • פיתוח קודם כל בארגז חול: תמיד צריך לאמת תכונות שילוב חדשות בחשבון בדיקה לפני שמיישמים אותן בסביבת הייצור.
  • בדיקות שילוב אוטומטיות: שימוש בחשבונות בדיקה כסביבות יציבות להרצת בדיקות רגרסיה אוטומטיות.
  • מתן שמות לחשבונות בדיקה: השתמשו ב-account_name כדי לרמוז על המטרה של כל חשבון בדיקה, כמו "בדיקת העברה" או "חשבון בדיקת שילוב".
הקודם
Access your account
הבא
Merchant API MCP Access Service