سيتم إيقاف الإصدار التجريبي v1 من Merchant API نهائيًا في 28 فبراير 2026. للاطّلاع على خطوات الانتقال إلى أحدث إصدار ثابت، يُرجى قراءة مقالة نقل البيانات من الإصدار التجريبي 1 إلى الإصدار 1.

إدارة إعدادات قناة التسويق الشاملة

‫OmnichannelSettings API هي نقطة الدخول إلى إعداد برامج "الإعلانات للمنتجات داخل المتجر" (LIA) و"البيانات المحلية المجانية" (FLL).

استخدِمها بشكل آلي

إدارة إعدادات القنوات المتعددة (إنشاؤها وتعديلها)
جلب (الحصول على قائمة) إعدادات القنوات المتعددة
طلب التحقّق من معلومات المخزون للتجّار المؤهّلين

لمزيد من المعلومات، يمكنك الاطّلاع على نظرة عامة على "إعلانات للمنتجات داخل المتجر" والبيانات المحلية المجانية.

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

يجب أن يتوفّر لديك ما يلي:

حساب على Merchant Center
ملف تجاري إذا لم يكن لديك حساب، يمكنك إنشاء حساب. اطّلِع على مقالة الاشتراك في "الملف التجاري على Google".
رابط بين ملفك التجاري وحسابك على Merchant Center لإنشاء الرابط، يمكنك استخدام واجهة مستخدم Merchant Center أو Merchant API (راجِع ربط ملف تجاري على Google).

إنشاء إعداد قناة تسويق شاملة

يمكنك استخدام طريقة omnichannelSettings.create لإنشاء إعدادات متعددة القنوات. تتلقّى طريقة الإنشاء مورد omnichannelSetting كإدخال وتعرض إعدادات القنوات المتعددة التي تم إنشاؤها، إذا تمت العملية بنجاح.

عند إنشاء السمة، يجب ملء كل من regionCode وLsfType:

يتم ضبط OmnichannelSetting على مستوى كل بلد. تحدّد السمة RegionCode البلد المستهدَف. بعد إنشائه، لا يمكنك تغييره. يجب أن تلتزم RegionCode بقاعدة التسمية التي يحدّدها مشروع مستودع بيانات المواقع الجغرافية المشتركة (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) غير المؤهَّل إلى عدم الموافقة على التطبيق.

بعد تنفيذ الطلب بنجاح، من المفترض أن يظهر لك الردّ التالي:

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

يؤدي تسجيل ميزات مختلفة من ميزات "التسوّق داخل المتجر" أو "المنتجات المتوفرة داخل المتجر" باستخدام الحقول omnichannelSetting إلى بدء عمليات مراجعة يدوية تستغرق عادةً من بضع ساعات إلى بضعة أيام. ننصحك بالتحقّق من صحة البيانات التي أدخلتها لتجنُّب الانتظار غير الضروري بسبب بيانات غير مؤهَّلة.

لعرض إعدادات القنوات الشاملة التي تم إنشاؤها حديثًا أو التحقّق من حالة المراجعات، استخدِم accounts.omnichannelSettings.get أو accounts.omnichannelSettings.list مع تحديد البلد.

نوع واجهة المحل المجاور (LSF)

استنادًا إلى صفحة المنتج التي تخطّط لاستخدامها، اختَر LsfType:

نوع صفحة المنتج	LsfType	قيمة التعداد
صفحات المنتجات مع عرض التوفّر في المتجر	واجهة محلّ مجاور يستضيفها تاجر (أساسية)	`MHLSF_BASIC`
صفحات منتجات تعرض معلومات التوفّر والسعر في متجر معيّن	واجهة محلّ محلية يستضيفها تاجر (كاملة)	`MHLSF_FULL`
صفحات المنتجات التي لا تعرض معلومات التوفّر في المتجر	واجهة محلّ مجاور تستضيفها Google ‏ (GHLSF)	`GHLSF`

في حال اختيار أنواع واجهة محلّ مجاور يستضيفها تاجر، عليك أيضًا ملء حقل URI بواحد على الأقل من inStock أو pickup.

InStock

يمكنك استخدام InStock لتقديم المزيد من المعلومات عن صفحة منتجك.

إذا اخترت أنواع Merchant-Hosted 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.

إلى أن يتم تأكيد عنوان 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 الخاصة بحسابك، استخدِم طريقة 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]

عرض حالة إعداد القنوات الشاملة

للاطّلاع على حالة مراجعات إعداد برنامج "الإعلانات داخل المتجر"، ابحث عن السمات ذات الصلة 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` وحلّها

يوضّح هذا القسم كيفية تحديد المشاكل الشائعة وحلّها.

إنشاء إعداد قناة تسويق شاملة

احرص على ضبط كلّ من LsfType وRegionCode.
إذا اخترت GHLSF، قدِّم InStock فارغًا في الطلب.
في حال اختيار أنواع LSF المستضافة من التاجر، يجب تقديم معرّف موارد موحّد واحد على الأقل في 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 ساعة تقريبًا.
في حال تكرار حالات تعذُّر إجراء فحص المستودع (أكثر من خمس مرات)، تفرض الخدمة فترة انتظار مدتها ثلاثون يومًا قبل السماح بتقديم طلب آخر. يُرجى التواصل مع فريق دعم Google إذا أردت تقديم طلب لاسترداد رصيد الاتصال قبل ذلك الوقت.

مزيد من المعلومات

لمزيد من التفاصيل، يُرجى الاطّلاع على مركز مساعدة "إعلانات للمنتجات داخل المتجر" والبيانات المحلية المجانية.

إدارة إعدادات قناة التسويق الشاملة تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

إنشاء إعداد قناة تسويق شاملة

نوع واجهة المحل المجاور (LSF)

InStock

استلام الطلب

معروض للطلب

لمحة (ألمانيا والنمسا وسويسرا)

إثبات صحة معلومات المستودع

الحصول على إعدادات قناة التسويق الشاملة

عرض إعدادات قناة التسويق الشاملة

تعديل إعدادات القنوات المتعددة

طلب التحقّق من معلومات المستودع

عرض حالة إعداد القنوات الشاملة

تحديد المشاكل المتعلّقة بواجهة برمجة التطبيقات OmnichannelSettings وحلّها

إنشاء إعداد قناة تسويق شاملة

تعديل إعدادات القنوات المتعددة

طلب التحقّق من معلومات المستودع

مزيد من المعلومات

إدارة إعدادات قناة التسويق الشاملة

تحديد المشاكل المتعلّقة بواجهة برمجة التطبيقات `OmnichannelSettings` وحلّها