דף זה תורגם על ידי Cloud Translation API.

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

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

אפשר להשתמש בה כדי

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

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

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

אתם צריכים

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

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

אפשר להשתמש ב-method‏ omnichannelSettings.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]

איסוף

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

כשמוצר מסומן לאיסוף, המשמעות היא שהלקוח יכול לקנות אותו אונליין ולאסוף אותו בחנות. הגדרת השדה 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.

עד שכתובת ה-URL של דף המידע הכללי תאומת, מוכרים ב-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.

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

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

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

דוגמה לקוד:

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. המשמעות היא שצריך לבקש אימות מלאי כדי להציג מודעות LIA.

ל-InventoryVerification.State יש את הערכים הבאים:

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

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

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

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

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

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

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

אי אפשר לשנות את קוד האזור.
אי אפשר לבצע עדכונים בזמן שתכונות LIA או FLL פועלות או אושרו.
כשעוברים מסוגים של LSF שמתארחים אצל המוכר ל-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