تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

OmnichannelSettings API هي نقطة الدخول لضبط برامج "إعلانات المنتجات داخل المتجر" و"البيانات المحلية المجانية".

استخدامها آليًا

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

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

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

يجب أن يكون لديك

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

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

يمكنك استخدام الطريقة 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) غير مؤهَّل إلى منع الموافقة.

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

{
  "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، مع تحديد البلد.

نوع واجهة المحل المجاور

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

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

إذا اخترت أنواع "واجهة محلّ مجاور يستضيفها تاجر"، عليك أيضًا ملء حقل عنوان URL لأحد النوعَين التاليَين على الأقل: inStock أو pickup.

InStock

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

إذا اخترت أنواع بيانات المنتجات في خدمة مقارنة الأسعار المستضافة من التاجر وحدّدت حقل عنوان URL في سمة InStock، هذا يعني أنّك تريد عرض منتجات متوفّرة. سنبدأ بمراجعة استنادًا إلى عنوان URL المقدَّم.

إذا اخترت النوع GHLSF، عليك تقديم حقل InStock فارغ في الطلب. على عكس أنواع المستودعات التي يستضيفها التاجر، عليك إكمال عملية إثبات صحة معلومات المستودع لإكمال عملية الإعداد.

ينشئ نموذج التعليمات البرمجية هذا 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.

بالنسبة إلى جميع التجّار في هذه البلدان الثلاثة، لا تفعّل الخدمة ميزتَي "الإعلانات أثناء عرض الفيديو" أو "الإعلانات أثناء عرض الفيديو على شبكة البحث" إلى أن تتلقّى صفحة "لمحة" موافقة.

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

لا تكون عملية إثبات صحة معلومات المستودع مطلوبة إلا للتجار الذين لديهم 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]

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

للتحقّق من حالة مراجعة مراجعات إعداد 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` وحلّها

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

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

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

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

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

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

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

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

نوع واجهة المحل المجاور

InStock

استلام الطلب

معروض للطلب

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

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

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

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

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

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

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

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

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

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

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

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

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

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