OmnichannelSettings API là điểm truy cập để định cấu hình 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 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 (lấy và liệt kê) chế độ cài đặt đa kênh
- Yêu cầu xác minh kho hàng cho 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 nên 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 bài viết Đăng ký Trang doanh nghiệp.
Đường 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 chế độ cài đặt đa kênh. Phương thức tạo lấy tài nguyên omnichannelSetting
làm dữ liệu đầ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 áp dụng 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 ngôn ngữ chung (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 xemLsfType
.
Để 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 phải điền tất cả các trường ở giai đoạn tạo, mà có thể định cấu hình các trường đó sau. Để cập nhật omnichannelSetting
hiện có, hãy xem phần Cập nhật chế độ cài đặt đa kênh.
Dưới đâ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/v1beta/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 do CLDR xác định{URI}
: URI hợp lệ được dùng cho bài đánh giá nhất định. 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ỹ dữ liệu đầu vào để tránh phải chờ đợi 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 bài đánh giá, hãy sử dụng accounts.omnichannelSettings.get
hoặc accounts.omnichannelSettings.list
, chỉ định quốc gia.
Loại trang chủ của 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ủa cửa hàng địa phương do người bán lưu trữ (Cơ bản) | 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 có 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 hai loại inStock
hoặc pickup
.
InStock
Bạn có thể sử dụng thuộc tính Còn hàng để cung cấp thêm thông tin về trang sản phẩm.
Nếu chọn loại LSF do người bán lưu trữ và chỉ định trường URI trong InStock, thì bạn đang cho biết ý định phân phát các 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 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 làm quen, 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.v1beta;
// [START merchantapi_create_omnichannel_setting]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.AccountName;
import com.google.shopping.merchant.accounts.v1beta.CreateOmnichannelSettingRequest;
import com.google.shopping.merchant.accounts.v1beta.InStock;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSetting.LsfType;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.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ể nâng cao chất lượng sản phẩm tại cửa hàng bằng tính năng Đến 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 hàng tại cửa hàng. Bằng cách đặt trường Pickup
, bạn đang cho thấy ý định phân phát sản phẩm có SLA về việc đến lấy hàng. Chúng tôi sẽ bắt đầu xem xét dựa trên URI được cung cấp.
Dưới đâ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/v1beta/accounts/{ACCOUNT_ID}/omnichannelSettings
{
"regionCode": "{REGION_CODE}",
"lsfType: "MHLSF_BASIC",
"pickup": {
"uri: "{URI}"
}
}
Có sẵn để đặt hàng
Nhờ tính năng hàng trưng bày có sẵn để đặt hàng, bạn có thể giới thiệu những sản phẩm được trưng bày trong cửa hàng thực tế nhưng chưa có sẵn hàng để bán ngay cho khách. 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ả của Google Tìm kiếm 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.
Trang 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
là gì.
Cho đến khi URL của 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
Quy trình Xác minh kho hàng chỉ bắt buộc đối với 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 người liên hệ. 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 một 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ư.
Sau khi hoàn tất bước này, 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 thông tin liên hệ trong quá trình xác minh hoặc sau khi xác minh bằ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 bạn cung cấp.
Nhận 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 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/v1beta/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 bài đánh giá đã đượ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ó thể đọ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 đến 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ê 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ã mẫu:
package shopping.merchant.samples.accounts.v1beta;
// [START merchantapi_list_omnichannel_settings]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.AccountName;
import com.google.shopping.merchant.accounts.v1beta.ListOmnichannelSettingsRequest;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceClient.ListOmnichannelSettingsPagedResponse;
import com.google.shopping.merchant.accounts.v1beta.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 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 không có trong mặt nạ cập nhật, thuộc tính sẽ không được cập nhật.
Nếu một thuộc tính có trong 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.v1beta;
// [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.v1beta.InventoryVerification;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSetting;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingName;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1beta.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ỉ liên quan đến người bán GHLSF
.
Trước khi gọi RPC này, bạn cần 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 xem xét trang
About
.
Để xác định xem bạn có đủ điều kiện hay không, hãy gọi omnichannelSettings.get
và kiểm tra omnichannelSetting.inventoryVerification.state
. Nếu thấy INACTIVE
, bạn có thể gọi omnichannelSettings.requestInventoryVerification
.
package shopping.merchant.samples.accounts.v1beta;
// [START merchantapi_request_inventory_verification]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingName;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceClient;
import com.google.shopping.merchant.accounts.v1beta.OmnichannelSettingsServiceSettings;
import com.google.shopping.merchant.accounts.v1beta.RequestInventoryVerificationRequest;
import com.google.shopping.merchant.accounts.v1beta.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á về quy trình làm quen với LIA, hãy kiểm tra ReviewState
để biết các thuộc tính tương ứng của omnichannelSetting
do phương thức omnichannelSettings.get
hoặc omnichannelSettings.list
trả về.
Trường ReviewState
áp dụng cho tất cả các bài đánh giá trong quy trình làm quen, 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
: Đã được phê duyệt.FAILED
: Đã bị từ chối.RUNNING
: Yêu cầu này vẫn đang được xem xét.ACTION_REQUIRED
: Thuộc tính này chỉ tồn tại trongInStock.state
đối với người bán trong GHLSF. Điều này có nghĩa là bạn cần yêu cầu xác minh khoảng không quảng cáo để LIA phân phát.
InventoryVerification.State
có các giá trị sau:
SUCCEEDED
: Đã đượ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étSUSPENDED
: 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 thêm một số hành động trước khi yêu cầu xác minh khoảng không quảng cáo.
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ộtInStock
trống trong yêu cầu. - Nếu bạn chọn 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ặcPickup
.
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ã khu vực.
- Bạn không thể cập nhật trong khi tính năng LIA/FLL đang chạy hoặc đã được phê duyệt.
- Khi thay đổi từ loại LSF do người bán lưu trữ thành
GHLSF
, nếu trước đó bạn đã định cấu hìnhInStock
vàPickup
, thì bạn phải đưa 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ậtLsfType
.
Ví dụ: nếu đã từng áp dụng MHLSF_BASIC
và Pickup
nhưng bị từ chối, bạn có thể chuyển sang GHLSF
bằng cách gửi yêu cầu như sau:
PATCH https://merchantapi.googleapis.com/accounts/v1beta/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 của CLDR
Yêu cầu xác minh kho hàng
Nếu mặc dù 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.
- Quá trình này sẽ mất khoảng 48 giờ.
- Trong trường hợp Kiểm tra kho hàng nhiều lần không thành công (trên 5 lần), dịch vụ này sẽ thực thi thời gian chờ 30 ngày trước khi cho phép 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 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.