השירות של Merchant API v1beta‎ יופסק וייצא משימוש ב-28 בפברואר 2026. הוראות למעבר לגרסה היציבה העדכנית זמינות במאמר מעבר מגרסה v1beta לגרסה v1.

ניהול ההגדרות בכל הערוצים

‫OmnichannelSettings API הוא נקודת הכניסה להגדרת התוכניות 'מודעות מלאי של חנויות מקומיות' (LIA) ו'כרטיסים חינמיים למוצרים מקומיים' (FLL).

אפשר להשתמש בו באופן פרוגרמטי

ניהול (יצירה ועדכון) הגדרות של ערוצים מרובים
אחזור (get ו-list) של הגדרות רב-ערוציות
בקשה לאימות מלאי למוכרים שעומדים בדרישות

כאן יש סקירה כללית בנושא מודעות מלאי של חנויות מקומיות וכרטיסים חינמיים למוצרים מקומיים.

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

צריך להיות לכם

חשבון Merchant Center
פרופיל העסק. אם אין לכם חשבון, אתם יכולים ליצור אחד. איך נרשמים לפרופיל עסק ב-Google
קישור בין פרופיל העסק לחשבון Merchant Center. כדי ליצור את הקישור, אפשר להשתמש בממשק המשתמש של Merchant Center או ב-Merchant API (ראו קישור פרופיל העסק ב-Google).

יצירת הגדרה בכל הערוצים

אפשר להשתמש ב-method‏ omnichannelSettings.create כדי ליצור הגדרת אומניצ'אנל. השיטה create מקבלת משאב omnichannelSetting כקלט ומחזירה את הגדרת האומניצ'אנל שנוצרה, אם הפעולה הצליחה.

כשיוצרים, צריך למלא את השדות regionCode ו-LsfType:

ההגדרה OmnichannelSetting היא לכל מדינה בנפרד. ‫RegionCode מגדיר את מדינת היעד. אחרי שיוצרים את המרחב, אי אפשר לשנות את ההגדרה הזו. השם RegionCode צריך להיות בהתאם לכלל השמות שמוגדר בפרויקט Common Locale Data Repository ‏(CLDR).
‫LsfType מבוסס על דף המוצר. פרטים נוספים זמינים במאמר LsfType.

לפרטים נוספים, אפשר לעיין במאמר בנושא שינוי חוויית המשתמש בדף המוצר שאליו מובילות מודעות מלאי של חנויות מקומיות.

לא חייבים למלא את כל השדות בשלב היצירה, אלא אפשר להגדיר אותם מאוחר יותר. כדי לעדכן omnichannelSetting קיים, אפשר לעיין במאמר בנושא עדכון הגדרות של ערוצים מרובים.

הנה דוגמה לבקשה אם בחרתם באפשרות MHLSF_BASIC ונרשמתם ל-inStock:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings

{
  "regionCode": "{REGION_CODE}",
  "lsfType: "MHLSF_BASIC",
  "inStock": {
      "uri": "{URI}"
  }
}

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center
‫{REGION_CODE}: קוד אזור כפי שמוגדר ב-CLDR
‫{URI}: ‏URI תקין שמשמש לביקורת הנתונה. כתובת URI שלא עומדת בדרישות עלולה למנוע אישור.

אחרי שהבקשה תפעל בהצלחה, תופיע התגובה הבאה:

{
  "name": "accounts/{ACCOUNT_ID}/omnichannelSettings/{omnichannel_setting}",
  "regionCode": "{REGION_CODE}",
  "lsfType: "MHLSF_BASIC",
  "inStock": {
      "uri": "{URI}",
      "state": "RUNNING"
  }
}

הפעלת תכונות שונות של LIA/FLL באמצעות שדות omnichannelSetting מפעילה בדיקות ידניות שנמשכות בדרך כלל כמה שעות או כמה ימים. מומלץ לבדוק שוב את הנתונים שהזנתם כדי להימנע מזמן המתנה מיותר בגלל נתונים שלא עומדים בדרישות.

כדי לראות את ההגדרה החדשה של ערוצים משולבים או לבדוק את סטטוס הביקורות, משתמשים ב-accounts.omnichannelSettings.get או ב-accounts.omnichannelSettings.list ומציינים את המדינה.

סוג דף של חנות מקומית (LSF)

בהתאם לדף המוצר שבו אתם מתכננים להשתמש, בוחרים באפשרות LsfType:

סוג דף המוצר	LsfType	ערך enum
דפי מוצר עם נתוני זמינות במלאי	דף של חנות מקומית באתר של המוכר (בסיסי)	`MHLSF_BASIC`
דפי מוצר עם נתוני מחיר וזמינות במלאי בחנות ספציפית	דף של חנות מקומית באתר של המוכר (מלא)	`MHLSF_FULL`
דפי מוצר ללא נתוני זמינות במלאי	דף של חנות מקומית ב-Google‏ (GHLSF)	`GHLSF`

אם בוחרים באחד מסוגי דפי החנות באתר של המוכר, צריך גם למלא את שדה ה-URI לפחות באחת מהאפשרויות inStock או pickup.

InStock

אתם יכולים להשתמש ב-InStock כדי לספק מידע נוסף על דף המוצר.

אם בחרתם בסוגי דפי LSF שמתארחים באתר המוכר וציינתם את שדה ה-URI במאפיין InStock, אתם מביעים את הכוונה להציג מוצרים עם זמינות במלאי. נתחיל בבדיקה על סמך ה-URI שסיפקת.

אם בוחרים בסוג GHLSF, צריך לספק שדה InStock ריק בבקשה. בניגוד לסוגי דפי LSF שמתארחים באתר של המוכר, כדי להשלים את תהליך ההצטרפות, צריך להשלים את תהליך אימות המלאי.

בדוגמת הקוד הזו נוצר omnichannelSetting באמצעות GHLSF:

package shopping.merchant.samples.accounts.v1;

// [START merchantapi_create_omnichannel_setting]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccountName;
import com.google.shopping.merchant.accounts.v1.CreateOmnichannelSettingRequest;
import com.google.shopping.merchant.accounts.v1.InStock;
import com.google.shopping.merchant.accounts.v1.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1.OmnichannelSetting.LsfType;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to create an omnichannel setting for a given Merchant Center account
 *   in a given country
 */
public class CreateOmnichannelSettingSample {

  public static void createOmnichannelSetting(Config config, String regionCode) throws Exception {

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

    // Creates service settings using the retrieved credentials.
    OmnichannelSettingsServiceSettings omnichannelSettingsServiceSettings =
        OmnichannelSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (OmnichannelSettingsServiceClient omnichannelSettingsServiceClient =
        OmnichannelSettingsServiceClient.create(omnichannelSettingsServiceSettings)) {
      String accountId = config.getAccountId().toString();
      String parent = AccountName.newBuilder().setAccount(accountId).build().toString();

      // Creates an omnichannel setting with GHLSF type in the given country.
      CreateOmnichannelSettingRequest request =
          CreateOmnichannelSettingRequest.newBuilder()
              .setParent(parent)
              .setOmnichannelSetting(
                  OmnichannelSetting.newBuilder()
                      .setRegionCode(regionCode)
                      .setLsfType(LsfType.GHLSF)
                      .setInStock(InStock.getDefaultInstance())
                      .build())
              .build();

      System.out.println("Sending create omnichannel setting request:");
      OmnichannelSetting response =
          omnichannelSettingsServiceClient.createOmnichannelSetting(request);

      System.out.println("Inserted Omnichannel Setting below:");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // The country which you're targeting at.
    String regionCode = "{REGION_CODE}";

    createOmnichannelSetting(config, regionCode);
  }
}
// [END merchantapi_list_omnichannel_settings]

איסוף

בנוסף לנתוני זמינות במלאי, אתם יכולים גם להוסיף למוצרים בחנות את התכונה 'איסוף', שזמינה רק לסוגי דפי LSF שמתארחים באתר של המוכר.

כשמוצר מסומן לאיסוף, זה אומר שהלקוח יכול לקנות אותו אונליין ולאסוף אותו מהחנות. הגדרת השדה Pickup מציינת שאתם מתכוונים להציג מוצרים עם מועד זמינות לאיסוף. נתחיל בבדיקה על סמך ה-URI שסיפקת.

זוהי בקשה לדוגמה שיוצרת הגדרת omnichannel עם Pickup:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings

{
  "regionCode": "{REGION_CODE}",
  "lsfType: "MHLSF_BASIC",
  "pickup": {
     "uri: "{URI}"
  }
}

בתצוגה, למכירה בהזמנה בלבד

התכונה בתצוגה, למכירה בהזמנה בלבד מאפשרת לפרסם מוצרים שמוצגים בחנות פיזית אבל לא זמינים לרכישה מיידית. לדוגמה, רהיטים גדולים:

לקוחות שמחפשים מוצרים דומים ב-Google יראו את המודעות האלה בתוצאות החיפוש עם ההערה 'בחנות'.
לקוחות שמעיינים במוצרים מהחנות בדף תוצאות החיפוש ב-Google יראו את המוצרים האלה עם ההערה 'זמין להזמנה'.

כדי לראות את הפריט, הם יכולים ללחוץ על מודעת המלאי של החנות המקומית או על הכרטיס החינמי למוצר המקומי. כדי לקנות את הפריט, הם צריכים לבקר בחנות הפיזית שלכם, לראות את הפריט ולהזמין אותו. הם יכולים לבקש שתשלחו אותו אליהם או אל החנות שלכם לאיסוף.

מידע כללי (גרמניה, אוסטריה ושווייץ)

אם אתם מוכרים באוסטריה ובגרמניה ובחרתם באפשרות GHLSF, אתם צריכים לשלוח דף מידע כללי.

אם אתם מציגים מודעות בשווייץ, אתם צריכים לשלוח דף 'מידע כללי' בלי קשר לLsfType.

עד שכתובת האתר של הדף 'מידע כללי' תאומת, מוכרים GHLSF לא יכולים לבקש מ-Google אימות מלאי ידני.

כל המוכרים בשלוש המדינות האלה לא יכולים להשתמש בתכונות של FLL/LIA עד שהדף 'מידע נוסף' שלהם יאושר.

אימות מלאי

אימות מלאי נדרש רק למוכרים GHLSF. אין תמיכה בסוגים MHLSF.

לפני שמוסיפים נתוני מוצרים ונתוני מלאי (באמצעות accounts.products.localInventories.insert או ממשק המשתמש של Merchant Center) או אחרי שמוסיפים אותם, צריך לאמת את איש הקשר. מציינים איש קשר לאימות מלאי (שם וכתובת אימייל) באמצעות השיטה create או update. האיש קשר יקבל אימייל מ-Google, ויוכל לאמת את הסטטוס שלו בלחיצה על לחצן בהודעה.

אחרי שתשלימו את הפעולות האלה, תוכלו לבקש אימות מלאי. מידע נוסף על אימות מלאי

אפשר לשנות את איש הקשר במהלך תהליך האימות או אחרי האימות באמצעות omnichannelSetting.update.

אחרי שהתהליך הזה יסתיים, Google תאמת את דיוק המידע שסיפקתם.

אחזור הגדרה של ניהול שיחות מכל הערוצים

כדי לאחזר את ההגדרה של omnichannelSetting במדינה מסוימת או לבדוק את הסטטוס הנוכחי של הביקורות, משתמשים בשיטה omnichannelSettings.get.

לדוגמה:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings/{OMNICHANNEL_SETTING}

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center
‫{OMNICHANNEL_SETTING}: קוד האזור של מדינת היעד

הסטטוס ACTIVE מציין שהבקשה אושרה.

אם הסטטוס הוא FAILED, צריך לטפל בבעיות ולהפעיל בדיקה חדשה על ידי התקשרות אל omnichannelSetting.update.

בשדה LFP לקריאה בלבד מוצג סטטוס השותפות שלכם לניהול פידים של מלאי מוצרים בחנויות מקומיות. כדי לקשר לשותפות, משתמשים ב-lfpProviders.linkLfpProvider.

מידע נוסף על בדיקת הסטטוסים והמשמעויות שלהם זמין במאמר בנושא הצגת הסטטוס של הגדרת ערוצים מרובים.

הצגת הגדרות בכל הערוצים

כדי לאחזר את כל המידע על החשבון, משתמשים בשיטה omnichannelSettings.list.omnichannelSetting

דוגמה לקוד:

package shopping.merchant.samples.accounts.v1;

// [START merchantapi_list_omnichannel_settings]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccountName;
import com.google.shopping.merchant.accounts.v1.ListOmnichannelSettingsRequest;
import com.google.shopping.merchant.accounts.v1.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceClient.ListOmnichannelSettingsPagedResponse;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to get the list of omnichannel settings for a given Merchant Center
 *   account
 */
public class ListOmnichannelSettingsSample {

  public static void omnichannelSettings(Config config) throws Exception {

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

    // Creates service settings using the retrieved credentials.
    OmnichannelSettingsServiceSettings omnichannelSettingsServiceSettings =
        OmnichannelSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    String accountId = config.getAccountId().toString();
    String parent = AccountName.newBuilder().setAccount(accountId).build().toString();

    // Calls the API and catches and prints any network failures/errors.
    try (OmnichannelSettingsServiceClient omnichannelSettingsServiceClient =
        OmnichannelSettingsServiceClient.create(omnichannelSettingsServiceSettings)) {
      ListOmnichannelSettingsRequest request =
          ListOmnichannelSettingsRequest.newBuilder().setParent(parent).build();

      System.out.println("Sending list omnichannel setting request:");
      ListOmnichannelSettingsPagedResponse response =
          omnichannelSettingsServiceClient.listOmnichannelSettings(request);

      int count = 0;

      // Iterates over all the entries in the response.
      for (OmnichannelSetting omnichannelSetting : response.iterateAll()) {
        System.out.println(omnichannelSetting);
        count++;
      }
      System.out.println(String.format("The following count of elements were returned: %d", count));
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    omnichannelSettings(config);
  }
}
// [END merchantapi_list_omnichannel_settings]

עדכון הגדרה של שירות לקוחות בכל הערוצים

כדי לעדכן את ההגדרה הקיימת של ערוצים מרובים, משתמשים בשיטה omnichannelSettings.update.

כדי לעדכן, צריך להוסיף את התכונה הרצויה למסכת העדכון ולמלא את השדות המתאימים בשדה omnichannelSetting בבקשת העדכון. אפשר לעדכן כל אחד מהפרטים הבאים

lsfType
inStock
pickup
odo
about
inventoryVerification

אם מאפיין לא נכלל במסכת העדכון, הוא לא יעודכן.

אם מאפיין מסוים נכלל במסכת העדכון, אבל לא מוגדר בבקשה, הוא ינוקה.

דוגמת הקוד הבאה מראה איך לעדכן את השדה של אימות מלאי שטחי הפרסום.

package shopping.merchant.samples.accounts.v1;

// [START merchantapi_update_omnichannel_setting]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.protobuf.FieldMask;
import com.google.shopping.merchant.accounts.v1.InventoryVerification;
import com.google.shopping.merchant.accounts.v1.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingName;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1.UpdateOmnichannelSettingRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to update an omnichannel setting for a given Merchant Center account
 *   in a given country
 */
public class UpdateOmnichannelSettingSample {

  public static void updateOmnichannelSettings(
      Config config, String regionCode, String contact, String email) throws Exception {

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

    // Creates service settings using the retrieved credentials.
    OmnichannelSettingsServiceSettings omnichannelSettingsServiceSettings =
        OmnichannelSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (OmnichannelSettingsServiceClient omnichannelSettingsServiceClient =
        OmnichannelSettingsServiceClient.create(omnichannelSettingsServiceSettings)) {
      String accountId = config.getAccountId().toString();
      String name =
          OmnichannelSettingName.newBuilder()
              .setAccount(accountId)
              .setOmnichannelSetting(regionCode)
              .build()
              .toString();

      OmnichannelSetting omnichannelSetting =
          OmnichannelSetting.newBuilder()
              .setName(name)
              .setInventoryVerification(
                  InventoryVerification.newBuilder()
                      .setContact(contact)
                      .setContactEmail(email)
                      .build())
              .build();
      FieldMask fieldMask = FieldMask.newBuilder().addPaths("inventory_verification").build();
      UpdateOmnichannelSettingRequest request =
          UpdateOmnichannelSettingRequest.newBuilder()
              .setOmnichannelSetting(omnichannelSetting)
              .setUpdateMask(fieldMask)
              .build();

      System.out.println("Sending update omnichannel setting request:");
      OmnichannelSetting response =
          omnichannelSettingsServiceClient.updateOmnichannelSetting(request);

      System.out.println("Updated Omnichannel Setting below:");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // The country which you're targeting at.
    String regionCode = "{REGION_CODE}";
    // The name of the inventory verification contact you want to update.
    String contact = "{NAME}";
    // The address of the inventory verification email you want to update.
    String email = "{EMAIL}";

    updateOmnichannelSettings(config, regionCode, contact, email);
  }
}
// [END merchantapi_update_omnichannel_setting]

בקשה לאימות מלאי

המאמר הזה omnichannelSettings.requestInventoryVerification רלוונטי רק למוֹכרים GHLSF.

לפני שמפעילים את ה-RPC הזה, צריך לבצע את הפעולות הבאות:

מעלים את נתוני המוצרים והמלאי.
אימות איש קשר לאימות מלאי.
מוֹכרים באוסטריה, בגרמניה או בשווייץ צריכים להשלים בדיקה של דף About.

כדי לבדוק אם אתם עומדים בדרישות, אתם יכולים להתקשר למספר omnichannelSettings.get ולבדוק את omnichannelSetting.inventoryVerification.state. אם מופיע הסמל INACTIVE, אפשר להתקשר אל omnichannelSettings.requestInventoryVerification.

package shopping.merchant.samples.accounts.v1;

// [START merchantapi_request_inventory_verification]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingName;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1.OmnichannelSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1.RequestInventoryVerificationRequest;
import com.google.shopping.merchant.accounts.v1.RequestInventoryVerificationResponse;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to request inventory verification for a given Merchant Center account
 *   in a given country
 */
public class RequestInventoryVerificationSample {

  public static void requestInventoryVerification(Config config, String regionCode)
      throws Exception {

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

    // Creates service settings using the retrieved credentials.
    OmnichannelSettingsServiceSettings omnichannelSettingsServiceSettings =
        OmnichannelSettingsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (OmnichannelSettingsServiceClient omnichannelSettingsServiceClient =
        OmnichannelSettingsServiceClient.create(omnichannelSettingsServiceSettings)) {
      String accountId = config.getAccountId().toString();
      String name =
          OmnichannelSettingName.newBuilder()
              .setAccount(accountId)
              .setOmnichannelSetting(regionCode)
              .build()
              .toString();
      RequestInventoryVerificationRequest request =
          RequestInventoryVerificationRequest.newBuilder().setName(name).build();

      System.out.println("Sending request inventory verification request:");
      RequestInventoryVerificationResponse response =
          omnichannelSettingsServiceClient.requestInventoryVerification(request);

      System.out.println("Omnichannel Setting after inventory verification request below:");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // The country which you're targeting at.
    String regionCode = "{REGION_CODE}";

    requestInventoryVerification(config, regionCode);
  }
}
// [END merchantapi_request_inventory_verification]

הצגת הסטטוס של הגדרת אומניצ'אנל.

כדי לבדוק את סטטוס הבדיקה של הביקורות על תהליך ההצטרפות ל-LIA, בודקים את ReviewState המאפיינים התואמים של omnichannelSetting שמוחזרים על ידי השיטות omnichannelSettings.get או omnichannelSettings.list.

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

‫ACTIVE: הוא אושר.
‫FAILED: ההצעה נדחית.
RUNNING: עדיין בבדיקה.
‫ACTION_REQUIRED: המאפיין הזה קיים רק ב-InStock.state אצל מוכרים שמשתמשים ב-GHLSF. המשמעות היא שצריך לבקש אימות מלאי כדי להציג מודעות לרכישה בחנויות מקומיות.

‫InventoryVerification.State יכול לקבל את הערכים הבאים:

‫SUCCEEDED: הוא אושר.
INACTIVE: אפשר לבקש אימות מלאי.
RUNNING: בבדיקה
‫SUSPENDED: נכשלתם באימות המלאי יותר מדי פעמים (בדרך כלל 5), ועליכם להמתין לפני שתוכלו לבקש אותו שוב.
‫ACTION_REQUIRED: צריך לבצע פעולות נוספות לפני שמבקשים אימות מלאי.

פתרון בעיות שקשורות ל-`OmnichannelSettings` API

בקטע הזה מוסבר איך לפתור בעיות נפוצות.

יצירת הגדרה בכל הערוצים

חשוב להגדיר גם את LsfType וגם את RegionCode.
אם בוחרים באפשרות GHLSF, צריך לספק בקשה ריקה InStock.
אם בוחרים סוגים של LSF שמתארחים אצל המוכר, צריך לספק לפחות URI אחד ב-InStock או ב-Pickup.

עדכון הגדרה של שירות לקוחות בכל הערוצים

שיטת העדכון של המשאב הזה מחייבת את הכללים הנוספים הבאים:

אי אפשר לשנות את קוד האזור.
אי אפשר לבצע עדכונים בזמן שהתכונה 'מבצעים על מוצרים בחנויות מקומיות' או 'מבצעים על מוצרים בחנויות מקומיות של מוכרים אחרים' פועלת או אושרה.
כשמשנים מסוגי דפי נחיתה עם טופס הזמנה שמתארחים באתר של המוכר ל-GHLSF, אם InStock ו-Pickup הוגדרו בעבר, צריך לכלול אותם במסכת העדכון יחד עם העדכון של LsfType.

לדוגמה, אם הגשתם בקשה להפעלת MHLSF_BASIC ו-Pickup בעבר והבקשה נדחתה, אתם יכולים לעבור ל-GHLSF על ידי שליחת בקשה כזו:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/omnichannelSettings/{REGION_CODE}?update_mask=lsf_type,in_stock,pickup

{
  "lsfType: "GHLSF",
  "inStock": {},
}

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center
‫{REGION_CODE}: קוד אזור כפי שמוגדר ב-CLDR

בקשה לאימות מלאי

אם, למרות שעדכנתם את פידי המוצרים או המלאי ואישרתם את איש הקשר, InventoryVerification.state שונה מ-INACTIVE:

מוֹכרים באוסטריה, בגרמניה ובשווייץ: מוודאים שהשלמתם את תהליך הבדיקה של הדף 'מידע כללי'.
תהיה השהיה של כ-48 שעות.
אם בדיקת המלאי נכשלת שוב ושוב (יותר מחמש פעמים), השירות יחיל תקופת צינון של 30 יום לפני שניתן יהיה לשלוח בקשה נוספת. אפשר לפנות לתמיכה של Google כדי לבקש שההחזר יועבר מוקדם יותר.

מידע נוסף

פרטים נוספים זמינים במרכז העזרה בנושא מודעות מלאי של חנויות מקומיות וכרטיסים חינמיים למוצרים מקומיים.

ניהול ההגדרות בכל הערוצים קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

יצירת הגדרה בכל הערוצים

סוג דף של חנות מקומית (LSF)

InStock

איסוף

בתצוגה, למכירה בהזמנה בלבד

מידע כללי (גרמניה, אוסטריה ושווייץ)

אימות מלאי

אחזור הגדרה של ניהול שיחות מכל הערוצים

הצגת הגדרות בכל הערוצים

עדכון הגדרה של שירות לקוחות בכל הערוצים

בקשה לאימות מלאי

הצגת הסטטוס של הגדרת אומניצ'אנל.

פתרון בעיות שקשורות ל-OmnichannelSettings API

יצירת הגדרה בכל הערוצים

עדכון הגדרה של שירות לקוחות בכל הערוצים

בקשה לאימות מלאי

מידע נוסף

ניהול ההגדרות בכל הערוצים

פתרון בעיות שקשורות ל-`OmnichannelSettings` API