نسخه بتای اول API فروشگاه در تاریخ ۲۸ فوریه ۲۰۲۶ متوقف و غیرفعال خواهد شد. برای مراحل انتقال به آخرین نسخه پایدار، به بخش «مهاجرت از نسخه بتای اول به نسخه ۱» مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تنظیمات omnichannel را مدیریت کنید

رابط برنامه‌نویسی کاربردی تنظیمات کانال همه‌کاره (OmnichannelSettings API) نقطه ورود به پیکربندی برنامه‌های تبلیغات موجودی محلی (LIA) و فهرست‌های محلی رایگان (FLL) شماست.

از آن به صورت برنامه‌نویسی استفاده کنید

مدیریت (ایجاد و به‌روزرسانی) تنظیمات omnichannel
تنظیمات omnichannel را دریافت و فهرست کنید (fetch and list)
درخواست تأیید موجودی برای فروشندگان واجد شرایط

برای اطلاعات بیشتر، به آگهی‌های موجودی محلی و نمای کلی فهرست‌های محلی رایگان مراجعه کنید.

پیش‌نیازها

باید داشتی.

یک حساب مرکز تجاری
یک نمایه تجاری. اگر ندارید، می‌توانید یکی ایجاد کنید. به بخش «ثبت‌نام برای نمایه تجاری» مراجعه کنید.
پیوندی بین نمایه تجاری شما و حساب مرکز فروشندگان شما. برای ایجاد پیوند، می‌توانید از رابط کاربری مرکز فروشندگان یا رابط برنامه‌نویسی کاربردی فروشندگان استفاده کنید ( به پیوند نمایه تجاری گوگل مراجعه کنید).

ایجاد تنظیمات همه کاناله

شما می‌توانید از متد omnichannelSettings.create برای ایجاد یک تنظیمات omnichannel استفاده کنید. متد create یک منبع omnichannelSetting را به عنوان ورودی دریافت می‌کند و در صورت موفقیت، تنظیمات omnichannel ایجاد شده را برمی‌گرداند.

هنگام ایجاد، باید هم regionCode و هم LsfType را وارد کنید:

تنظیمات Omnichannel بر اساس هر کشور انجام می‌شود. RegionCode کشور هدف را تعریف می‌کند. پس از ایجاد، نمی‌توانید آن را تغییر دهید. RegionCode باید از قانون نامگذاری تعریف شده توسط پروژه مخزن داده‌های محلی مشترک (CLDR) پیروی کند.
LsfType بر اساس صفحه محصول شما است. برای جزئیات بیشتر، به LsfType مراجعه کنید.

برای جزئیات بیشتر، به تغییر تجربه صفحه محصول برای تبلیغات موجودی محلی خود مراجعه کنید.

لازم نیست همه فیلدها را در مرحله ایجاد پر کنید، بلکه می‌توانید بعداً آنها را پیکربندی کنید. برای به‌روزرسانی omnichannelSetting موجود، به به‌روزرسانی تنظیمات omnichannel مراجعه کنید.

در اینجا یک نمونه درخواست برای انتخاب 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} : شناسه منحصر به فرد حساب مرکز فروش شما
{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 باعث بررسی‌های دستی می‌شود که معمولاً به چند ساعت تا چند روز زمان نیاز دارند. توصیه می‌کنیم ورودی‌های خود را دوباره بررسی کنید تا از زمان انتظار غیرضروری به دلیل داده‌های نامناسب جلوگیری شود.

برای مشاهده تنظیمات omnichannel تازه ایجاد شده یا بررسی وضعیت نظرات، accounts.omnichannelSettings.get یا accounts.omnichannelSettings.list با مشخص کردن کشور استفاده کنید.

نوع ویترین فروشگاه محلی (LSF)

بر اساس صفحه محصولی که قصد استفاده از آن را دارید، یک LsfType انتخاب کنید:

نوع صفحه محصول	نوع LSF	مقدار شمارشی
صفحات محصول با قابلیت نمایش در فروشگاه	نمای فروشگاه محلی میزبان فروشنده پایه	`MHLSF_BASIC`
صفحات محصولات خاص فروشگاه با موجودی و قیمت	فروشگاه محلی با میزبانی فروشنده، نمای کامل فروشگاه	`MHLSF_FULL`
صفحات محصول بدون موجودی در فروشگاه	فروشگاه محلی تحت میزبانی گوگل (GHLSF)	`GHLSF`

اگر انواع فروشگاه محلی با میزبانی فروشنده (Merchant-hosted) را انتخاب می‌کنید، باید فیلد URI را برای حداقل یکی از گزینه‌های موجود inStock یا pickup نیز پر کنید.

موجود در انبار

شما می‌توانید از 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 میزبان فروشنده (Merchant-hosted LSF) واجد شرایط است، ارتقا دهید.

وقتی محصولی برای تحویل گرفتن علامت‌گذاری می‌شود، به این معنی است که مشتری می‌تواند آن را به صورت آنلاین خریداری کرده و در فروشگاه تحویل بگیرد. با تنظیم فیلد Pickup ، شما قصد خود را برای ارائه محصولات با SLA تحویل گرفتن نشان می‌دهید. ما بر اساس URI ارائه شده، بررسی را شروع خواهیم کرد.

در اینجا یک درخواست نمونه وجود دارد که با Pickup یک تنظیمات omnichannel ایجاد می‌کند:

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

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

قابل نمایش برای سفارش

با قابلیت نمایش سفارش ، می‌توانید محصولاتی را که در فروشگاه فیزیکی شما نمایش داده می‌شوند اما برای خرید فوری در دسترس نیستند، نمایش دهید. به عنوان مثال، مبلمان بزرگ:

مشتریانی که به دنبال محصولات مشابه در گوگل هستند، این تبلیغات را با حاشیه‌نویسی «در فروشگاه» در نتایج جستجوی خود مشاهده خواهند کرد.
مشتریانی که در صفحه نتایج جستجوی گوگل در حال مرور فروشگاه هستند، این محصولات را با علامت «موجود برای سفارش» مشاهده خواهند کرد.

آنها می‌توانند آگهی موجودی محلی یا فهرست محلی رایگان شما را برای مشاهده کالا انتخاب کنند. برای خرید کالا، می‌توانند از فروشگاه فیزیکی شما دیدن کنند، کالا را مشاهده کنند و سپس سفارش دهند که برای آنها ارسال شود یا برای تحویل گرفتن به فروشگاه شما ارسال شود.

درباره (آلمان، اتریش و سوئیس)

اگر در اتریش و آلمان خدمت می‌کنید و GHLSF انتخاب می‌کنید، باید یک صفحه «درباره ما » ارسال کنید.

اگر در سوئیس خدمت می‌کنید، صرف نظر از LsfType ، باید یک صفحه «درباره ما» ارسال کنید.

تا زمانی که آدرس اینترنتی صفحه «درباره ما» تأیید نشود، فروشندگان GHLSF نمی‌توانند از گوگل درخواست تأیید دستی موجودی کنند.

برای همه فروشندگان در این سه کشور، این سرویس ویژگی‌های FLL/LIA را تا زمانی که صفحه «درباره ما» شما تأیید نشود، فعال نمی‌کند.

تأیید موجودی

تأیید موجودی فقط برای فروشندگان GHLSF الزامی است. این مورد برای انواع MHLSF پشتیبانی نمی‌شود.

قبل یا بعد از اضافه کردن داده‌های محصول و داده‌های موجودی (چه با استفاده از accounts.products.localInventories.insert و چه با استفاده از رابط کاربری مرکز فروشندگان)، باید مخاطب خود را تأیید کنید. با استفاده از متد create یا update ، یک مخاطب تأیید موجودی (نام و آدرس ایمیل) ارائه دهید. مخاطب ایمیلی از طرف گوگل دریافت می‌کند و می‌تواند با کلیک روی دکمه‌ای در پیام، وضعیت خود را تأیید کند.

پس از تکمیل این مرحله، می‌توانید درخواست تأیید موجودی کالا را بدهید . برای اطلاعات بیشتر به «درباره تأیید موجودی کالا» مراجعه کنید.

شما می‌توانید مخاطب خود را در طول فرآیند تأیید یا پس از تأیید با استفاده از omnichannelSetting.update تغییر دهید.

پس از اتمام این فرآیند، گوگل صحت اطلاعات ارائه شده را تأیید می‌کند.

یک تنظیم omnichannel دریافت کنید

برای بازیابی پیکربندی omnichannelSetting در یک کشور مشخص، یا بررسی وضعیت فعلی نظرات خود، از متد omnichannelSettings.get استفاده کنید.

در اینجا یک نمونه درخواست آمده است:

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

موارد زیر را جایگزین کنید:

{ACCOUNT_ID} : شناسه منحصر به فرد حساب مرکز فروش شما
{OMNICHANNEL_SETTING} : کد منطقه کشور مورد نظر شما

وضعیت ACTIVE نشان می‌دهد که بررسی تأیید شده است.

اگر وضعیت FAILED است، با فراخوانی omnichannelSetting.update ، مشکلات را برطرف کرده و یک بررسی جدید را آغاز کنید.

فیلد LFP فقط خواندنی، وضعیت مشارکت فیدهای محلی شما را نشان می‌دهد. برای پیوند به این مشارکت، از lfpProviders.linkLfpProvider استفاده کنید.

برای اطلاعات بیشتر در مورد بررسی وضعیت‌ها و معانی آنها، به مشاهده وضعیت تنظیمات omnichannel مراجعه کنید.

تنظیمات omnichannel را فهرست کنید

برای بازیابی تمام اطلاعات omnichannelSetting برای حساب کاربری خود، از متد 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]

به‌روزرسانی تنظیمات omnichannel

برای به‌روزرسانی پیکربندی یک تنظیمات omnichannel موجود، از متد 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]

وضعیت تنظیمات omnichannel را مشاهده کنید.

برای بررسی وضعیت بررسی‌های مربوط به ثبت‌نام اولیه در LIA، ReviewState ، ویژگی‌های متناظر omnichannelSetting که توسط متدهای omnichannelSettings.get یا omnichannelSettings.list برگردانده می‌شوند را بررسی کنید.

فیلد ReviewState به جز فرآیند تأیید موجودی، برای همه بررسی‌های ورود به سیستم اعمال می‌شود و می‌تواند مقادیر زیر را داشته باشد:

ACTIVE : مورد تایید است.
FAILED : رد شده است.
RUNNING : هنوز در دست بررسی است.
ACTION_REQUIRED : این مورد فقط در InStock.state برای فروشندگان GHLSF وجود دارد. این بدان معناست که برای ارائه خدمات LIA، باید درخواست تأیید موجودی بدهید.

InventoryVerification.State دارای مقادیر زیر است:

SUCCEEDED : تصویب شد.
INACTIVE : شما آماده درخواست تأیید موجودی هستید.
RUNNING : در دست بررسی است
SUSPENDED : شما بارها (معمولاً ۵ بار) در تأیید موجودی شکست خورده‌اید و باید صبر کنید تا بتوانید دوباره آن را درخواست کنید.
ACTION_REQUIRED : قبل از درخواست تأیید موجودی، باید اقدامات دیگری انجام دهید.

عیب‌یابی مشکلات مربوط به `OmnichannelSettings` API

این بخش نحوه عیب‌یابی مشکلات رایج را شرح می‌دهد.

ایجاد تنظیمات همه کاناله

مطمئن شوید که هر دو LsfType و RegionCode را تنظیم کرده‌اید.
اگر GHLSF را انتخاب می‌کنید، در درخواست، یک InStock خالی ارائه دهید.
اگر انواع LSF میزبان-فروشگاهی را انتخاب می‌کنید، حداقل یک URI در InStock یا Pickup ارائه دهید.

به‌روزرسانی تنظیمات omnichannel

روش به‌روزرسانی برای این منبع به قوانین اضافی زیر نیاز دارد:

شما نمی‌توانید کد منطقه را تغییر دهید.
شما نمی‌توانید در حالی که ویژگی 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} : شناسه منحصر به فرد حساب مرکز فروش شما
{REGION_CODE} : کد منطقه به صورت CLDR تعریف شده

درخواست تأیید موجودی

اگر، علیرغم به‌روزرسانی فیدهای محصول یا موجودی و تأیید مخاطب، InventoryVerification.state INACTIVE باشد:

برای بازرگانان در اتریش، آلمان و سوئیس: مطمئن شوید که بررسی صفحه «درباره ما» را تکمیل کرده‌اید.
حدود ۴۸ ساعت تاخیر خواهد داشت.
در صورت تکرار خطای بررسی موجودی (بیش از پنج بار)، سرویس قبل از اجازه دادن به درخواست دیگر، یک دوره زمانی سی روزه برای رفع مشکل اعمال می‌کند. اگر می‌خواهید زودتر درخواست دهید، با پشتیبانی گوگل تماس بگیرید.

بیشتر بدانید

برای جزئیات بیشتر، به مرکز راهنمایی آگهی‌های موجودی محلی و فهرست‌های محلی رایگان مراجعه کنید.

تنظیمات omnichannel را مدیریت کنید با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیش‌نیازها

ایجاد تنظیمات همه کاناله

نوع ویترین فروشگاه محلی (LSF)

موجود در انبار

وانت

قابل نمایش برای سفارش

درباره (آلمان، اتریش و سوئیس)

تأیید موجودی

یک تنظیم omnichannel دریافت کنید

تنظیمات omnichannel را فهرست کنید

به‌روزرسانی تنظیمات omnichannel

درخواست تأیید موجودی

وضعیت تنظیمات omnichannel را مشاهده کنید.

عیب‌یابی مشکلات مربوط به OmnichannelSettings API

ایجاد تنظیمات همه کاناله

به‌روزرسانی تنظیمات omnichannel

درخواست تأیید موجودی

بیشتر بدانید

تنظیمات omnichannel را مدیریت کنید

عیب‌یابی مشکلات مربوط به `OmnichannelSettings` API