Merchant API phiên bản v1beta sẽ ngừng hoạt động và đóng cửa vào ngày 28 tháng 2 năm 2026. Để biết các bước chuyển đổi sang phiên bản ổn định mới nhất, hãy xem phần Di chuyển từ v1beta sang v1.

Quản lý chế độ cài đặt omnichannel

OmnichannelSettings API là điểm truy cập để định cấu hình các chương trình Quảng cáo kho hàng tại địa phương (LIA) và Trang thông tin miễn phí tại địa phương (FLL).

Sử dụng công cụ này theo phương thức lập trình

Quản lý (tạo và cập nhật) chế độ cài đặt đa kênh
Tìm nạp (nhận và liệt kê) các chế độ cài đặt đa kênh
Yêu cầu xác minh kho hàng đối với những người bán đủ điều kiện

Để biết thêm thông tin, hãy xem bài viết Tổng quan về quảng cáo kho hàng tại địa phương và trang thông tin miễn phí tại địa phương.

Điều kiện tiên quyết

Bạn phải có

tài khoản Merchant Center
Trang doanh nghiệp. Nếu chưa có, bạn có thể tạo một tài khoản. Xem phần Đăng ký Trang doanh nghiệp.
Mối liên kết giữa Trang doanh nghiệp và tài khoản Merchant Center. Để tạo mối liên kết, bạn có thể sử dụng giao diện người dùng Merchant Center hoặc Merchant API (xem phần Liên kết Trang doanh nghiệp trên Google).

Tạo chế độ cài đặt đa kênh

Bạn có thể sử dụng phương thức omnichannelSettings.create để tạo một chế độ cài đặt đa kênh. Phương thức tạo nhận tài nguyên omnichannelSetting làm đầu vào và trả về chế độ cài đặt đa kênh đã tạo (nếu thành công).

Khi tạo, bạn phải điền cả regionCode và LsfType:

OmnichannelSetting được thiết lập theo từng quốc gia. RegionCode xác định quốc gia mục tiêu. Sau khi tạo, bạn không thể thay đổi tên này. RegionCode phải tuân theo quy tắc đặt tên do dự án Kho dữ liệu chung về ngôn ngữ địa phương (CLDR) xác định.
LsfType dựa trên trang sản phẩm của bạn. Để biết thông tin chi tiết, hãy xem LsfType.

Để biết thêm thông tin chi tiết, hãy xem bài viết Thay đổi trải nghiệm trên trang sản phẩm cho quảng cáo kho hàng tại địa phương.

Bạn không cần phải điền tất cả các trường ở giai đoạn tạo, mà có thể định cấu hình chúng sau. Để cập nhật một omnichannelSetting hiện có, hãy xem phần Cập nhật chế độ cài đặt đa kênh.

Sau đây là yêu cầu mẫu nếu bạn chọn MHLSF_BASIC và đăng ký inStock:

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

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

Thay thế nội dung sau:

{ACCOUNT_ID}: Giá trị nhận dạng duy nhất của tài khoản Merchant Center
{REGION_CODE}: Mã vùng theo định nghĩa của CLDR
{URI}: Một URI hợp lệ được dùng cho bài đánh giá đã cho. Một URI không đủ điều kiện có thể ngăn việc phê duyệt.

Sau khi yêu cầu chạy thành công, bạn sẽ thấy phản hồi sau:

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

Việc đăng ký các tính năng LIA/FLL khác nhau bằng cách sử dụng các trường omnichannelSetting sẽ kích hoạt quy trình xem xét thủ công, thường mất từ vài giờ đến vài ngày. Bạn nên kiểm tra kỹ thông tin đầu vào để tránh thời gian chờ không cần thiết do dữ liệu không đủ điều kiện.

Để xem chế độ cài đặt đa kênh mới tạo hoặc kiểm tra trạng thái của các bài đánh giá, hãy sử dụng accounts.omnichannelSettings.get hoặc accounts.omnichannelSettings.list, đồng thời chỉ định quốc gia.

Loại trang chủ cửa hàng địa phương (LSF)

Dựa trên trang sản phẩm mà bạn dự định sử dụng, hãy chọn một LsfType:

Loại trang sản phẩm	LsfType	Giá trị enum
Trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng	Trang chủ cơ bản của cửa hàng địa phương do người bán lưu trữ	`MHLSF_BASIC`
Trang sản phẩm theo từng cửa hàng kèm tình trạng còn hàng và giá	Trang chủ của cửa hàng địa phương do người bán lưu trữ (đầy đủ)	`MHLSF_FULL`
Trang sản phẩm không cho biết tình trạng còn hàng tại cửa hàng	Trang chủ của cửa hàng địa phương do Google lưu trữ (GHLSF)	`GHLSF`

Nếu chọn loại Trang chủ cửa hàng địa phương do người bán lưu trữ, bạn cũng cần điền vào trường URI cho ít nhất một trong các loại inStock hoặc pickup.

InStock

Bạn có thể sử dụng InStock để cung cấp thêm thông tin về trang sản phẩm của mình.

Nếu chọn loại LSF do người bán lưu trữ và chỉ định trường URI trong InStock, tức là bạn đang cho biết ý định phân phát sản phẩm có tình trạng còn hàng. Chúng tôi sẽ bắt đầu xem xét dựa trên URI được cung cấp.

Nếu chọn loại GHLSF, bạn cần cung cấp một trường InStock trống trong yêu cầu. Không giống như các loại LSF do người bán lưu trữ, để hoàn tất quy trình tham gia, bạn cần hoàn tất quy trình Xác minh kho hàng.

Mã mẫu này tạo một omnichannelSetting bằng 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]

Đến lấy hàng

Ngoài tình trạng còn hàng tại cửa hàng, bạn cũng có thể cung cấp thêm thông tin cho sản phẩm tại cửa hàng bằng tính năng Lấy hàng. Tính năng này chỉ đủ điều kiện cho các loại LSF do người bán lưu trữ.

Khi một sản phẩm được đánh dấu là Lấy tại cửa hàng, tức là khách hàng có thể mua sản phẩm đó trên mạng rồi đến lấy tại cửa hàng. Bằng cách đặt trường Pickup, bạn đang thể hiện ý định phân phát sản phẩm có ngày dự kiến có thể đến lấy. Chúng tôi sẽ bắt đầu xem xét dựa trên URI mà bạn cung cấp.

Sau đây là một yêu cầu mẫu tạo chế độ cài đặt omnichannel bằng Pickup:

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

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

Có sẵn để đặt hàng

Nhờ tính năng có sẵn để đặt hàng, bạn có thể giới thiệu các sản phẩm được trưng bày trong cửa hàng thực tế nhưng không có sẵn để mua ngay. Ví dụ: đồ nội thất cỡ lớn:

Những khách hàng đang tìm kiếm các sản phẩm tương tự trên Google sẽ nhìn thấy những quảng cáo này kèm chú thích "tại cửa hàng" trong phần kết quả tìm kiếm.
Khách hàng đang duyệt qua cửa hàng trên trang kết quả tìm kiếm của Google sẽ thấy những sản phẩm này được đánh dấu là "Có sẵn để đặt hàng".

Họ có thể chọn quảng cáo kho hàng tại địa phương hoặc trang thông tin miễn phí tại địa phương để xem mặt hàng. Để mua mặt hàng này, họ có thể đến cửa hàng thực tế, xem mặt hàng rồi đặt hàng để bạn vận chuyển đến cho họ hoặc vận chuyển đến cửa hàng để họ đến lấy hàng.

Giới thiệu (Đức, Áo và Thuỵ Sĩ)

Nếu đang phân phát ở Áo và Đức và chọn GHLSF, bạn phải gửi trang Giới thiệu.

Nếu đang phân phát ở Thuỵ Sĩ, bạn phải gửi trang "Giới thiệu" bất kể LsfType.

Cho đến khi URL trang Giới thiệu được xác minh, người bán GHLSF không thể yêu cầu Google xác minh kho hàng theo cách thủ công.

Đối với tất cả người bán ở 3 quốc gia này, dịch vụ sẽ không bật các tính năng FLL/LIA cho đến khi Trang giới thiệu của bạn được phê duyệt.

Xác minh kho hàng

Bạn chỉ cần xác minh kho hàng nếu là người bán GHLSF. Phương thức này không được hỗ trợ cho các loại MHLSF.

Trước hoặc sau khi thêm dữ liệu sản phẩm và dữ liệu kho hàng (bằng cách sử dụng accounts.products.localInventories.insert hoặc giao diện người dùng Merchant Center), bạn phải xác minh thông tin liên hệ của mình. Cung cấp thông tin liên hệ của người xác minh kho hàng (tên và địa chỉ email) bằng phương thức create hoặc update. Người liên hệ sẽ nhận được email do Google gửi và có thể xác minh trạng thái của họ bằng cách nhấp vào một nút trong thông báo.

Sau khi hoàn tất, bạn có thể Yêu cầu xác minh kho hàng. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về quy trình xác minh kho hàng.

Bạn có thể thay đổi người liên hệ trong quá trình xác minh hoặc sau khi xác minh bằng cách sử dụng omnichannelSetting.update.

Sau khi quy trình này hoàn tất, Google sẽ xác thực tính chính xác của thông tin được cung cấp.

Thiết lập chế độ cài đặt đa kênh

Để truy xuất cấu hình omnichannelSetting ở một quốc gia nhất định hoặc kiểm tra trạng thái hiện tại của các bài đánh giá, hãy sử dụng phương thức omnichannelSettings.get.

Sau đây là một yêu cầu mẫu:

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

Thay thế nội dung sau:

{ACCOUNT_ID}: Giá trị nhận dạng duy nhất của tài khoản Merchant Center
{OMNICHANNEL_SETTING}: Mã khu vực của quốc gia mục tiêu

Trạng thái ACTIVE cho biết rằng yêu cầu xem xét đã được phê duyệt.

Nếu trạng thái là FAILED, hãy giải quyết các vấn đề và kích hoạt quy trình xem xét mới bằng cách gọi omnichannelSetting.update.

Trường LFP chỉ đọc cho biết trạng thái Đối tác nguồn cấp dữ liệu địa phương. Để liên kết với mối quan hệ đối tác, hãy sử dụng lfpProviders.linkLfpProvider.

Để biết thêm thông tin về cách kiểm tra trạng thái và ý nghĩa của trạng thái, hãy xem bài viết Xem trạng thái của chế độ cài đặt đa kênh.

Liệt kê các chế độ cài đặt đa kênh

Để truy xuất tất cả thông tin omnichannelSetting cho tài khoản của bạn, hãy sử dụng phương thức omnichannelSettings.list.

Dưới đây là một mẫu mã:

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]

Cập nhật chế độ cài đặt đa kênh

Để cập nhật cấu hình của một chế độ cài đặt đa kênh hiện có, hãy sử dụng phương thức omnichannelSettings.update.

Để cập nhật, bạn phải thêm tính năng mà bạn muốn vào mặt nạ cập nhật và điền vào các trường tương ứng trong trường omnichannelSetting trong yêu cầu cập nhật. Bạn có thể cập nhật bất kỳ

lsfType
inStock
pickup
odo
about
inventoryVerification

Nếu một thuộc tính không có trong mặt nạ cập nhật, thì thuộc tính đó sẽ không được cập nhật.

Nếu một thuộc tính được đưa vào mặt nạ cập nhật nhưng không được đặt trong yêu cầu, thì thuộc tính đó sẽ bị xoá.

Mã mẫu sau đây minh hoạ cách cập nhật trường xác minh khoảng không quảng cáo.

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]

Yêu cầu xác minh kho hàng

omnichannelSettings.requestInventoryVerification chỉ áp dụng cho người bán GHLSF.

Trước khi gọi RPC này, bạn cần phải thực hiện những việc sau:

Tải dữ liệu sản phẩm và kho hàng lên.
Xác minh người liên hệ để xác minh kho hàng.
Đối với người bán ở Áo, Đức hoặc Thuỵ Sĩ, hãy hoàn tất quy trình đánh giá trang About.

Để xác định xem bạn có đủ điều kiện hay không, hãy gọi đến số omnichannelSettings.get và kiểm tra omnichannelSetting.inventoryVerification.state. Nếu thấy INACTIVE, tức là bạn đã sẵn sàng gọi 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]

Xem trạng thái của chế độ cài đặt đa kênh.

Để kiểm tra trạng thái xem xét của các bài đánh giá khi tham gia LIA, hãy kiểm tra ReviewState để biết các thuộc tính tương ứng của omnichannelSetting do các phương thức omnichannelSettings.get hoặc omnichannelSettings.list trả về.

Trường ReviewState áp dụng cho tất cả quy trình xem xét khi tham gia, ngoại trừ quy trình xác minh khoảng không quảng cáo và có thể có các giá trị sau:

ACTIVE: Yêu cầu được phê duyệt.
FAILED: Yêu cầu bị từ chối.
RUNNING: Chúng tôi vẫn đang xem xét.
ACTION_REQUIRED: Chỉ có trong InStock.state đối với người bán GHLSF. Điều này có nghĩa là bạn cần yêu cầu xác minh kho hàng để sử dụng quảng cáo kho hàng tại địa phương.

InventoryVerification.State có các giá trị sau:

SUCCEEDED: Yêu cầu được phê duyệt.
INACTIVE: Bạn đã sẵn sàng yêu cầu xác minh kho hàng.
RUNNING: Đang được xem xét
SUSPENDED: Bạn đã không xác minh được kho hàng quá nhiều lần (thường là 5 lần) và cần phải đợi trước khi có thể yêu cầu xác minh lại.
ACTION_REQUIRED: Bạn cần thực hiện các bước bổ sung trước khi yêu cầu xác minh kho hàng.

Khắc phục sự cố liên quan đến API `OmnichannelSettings`

Phần này mô tả cách khắc phục các vấn đề thường gặp.

Tạo chế độ cài đặt đa kênh

Hãy nhớ đặt cả LsfType và RegionCode.
Nếu bạn chọn GHLSF, hãy cung cấp một InStock trống trong yêu cầu.
Nếu bạn chọn các loại LSF do người bán lưu trữ, hãy cung cấp ít nhất một URI trong InStock hoặc Pickup.

Cập nhật chế độ cài đặt đa kênh

Phương thức cập nhật cho tài nguyên này yêu cầu các quy tắc bổ sung sau:

Bạn không thể sửa đổi mã vùng.
Bạn không thể cập nhật khi tính năng LIA/FLL đang chạy hoặc đã được phê duyệt.
Khi thay đổi từ các loại LSF do người bán lưu trữ thành GHLSF, nếu trước đó bạn đã định cấu hình InStock và Pickup, thì bạn phải thêm các loại này vào mặt nạ cập nhật cùng với nội dung cập nhật LsfType.

Ví dụ: nếu trước đây bạn đã áp dụng MHLSF_BASIC và Pickup nhưng bị từ chối, thì bạn có thể chuyển sang GHLSF bằng cách gửi một yêu cầu như sau:

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

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

Thay thế nội dung sau:

{ACCOUNT_ID}: Giá trị nhận dạng duy nhất của tài khoản Merchant Center
{REGION_CODE}: Mã vùng theo định nghĩa CLDR

Yêu cầu xác minh kho hàng

Nếu bạn đã cập nhật nguồn cấp dữ liệu sản phẩm hoặc kho hàng và xác nhận thông tin liên hệ nhưng InventoryVerification.state không phải là INACTIVE:

Đối với người bán ở Áo, Đức và Thuỵ Sĩ: Đảm bảo rằng bạn đã hoàn tất quy trình xem xét trang Giới thiệu.
Sẽ có một khoảng trễ khoảng 48 giờ.
Trong trường hợp bạn không thực hiện được quy trình Kiểm tra kho hàng nhiều lần (hơn 5 lần), dịch vụ sẽ áp dụng thời gian chờ là 30 ngày trước khi cho phép bạn gửi một yêu cầu khác. Hãy liên hệ với Nhóm hỗ trợ Google nếu bạn muốn yêu cầu hoàn tiền sớm hơn.

Tìm hiểu thêm

Để biết thêm thông tin chi tiết, hãy xem Trung tâm trợ giúp về quảng cáo kho hàng tại địa phương và trang thông tin miễn phí tại địa phương.

Quản lý chế độ cài đặt omnichannel Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Điều kiện tiên quyết

Tạo chế độ cài đặt đa kênh

Loại trang chủ cửa hàng địa phương (LSF)

InStock

Đến lấy hàng

Có sẵn để đặt hàng

Giới thiệu (Đức, Áo và Thuỵ Sĩ)

Xác minh kho hàng

Thiết lập chế độ cài đặt đa kênh

Liệt kê các chế độ cài đặt đa kênh

Cập nhật chế độ cài đặt đa kênh

Yêu cầu xác minh kho hàng

Xem trạng thái của chế độ cài đặt đa kênh.

Khắc phục sự cố liên quan đến API OmnichannelSettings

Tạo chế độ cài đặt đa kênh

Cập nhật chế độ cài đặt đa kênh

Yêu cầu xác minh kho hàng

Tìm hiểu thêm

Quản lý chế độ cài đặt omnichannel

Khắc phục sự cố liên quan đến API `OmnichannelSettings`