Phần này mô tả cách bạn có thể gửi nội dung cập nhật có tính thời gian của các thực thể khoảng không quảng cáo cho Google. API Cập nhật gia tăng cho phép bạn đẩy nội dung cập nhật và xoá các thực thể trong khoảng không quảng cáo Sandbox hoặc Production gần như theo thời gian thực.
Chức năng này chủ yếu dành cho các nội dung cập nhật mà bạn không thể lường trước được, chẳng hạn như việc đóng cửa khẩn cấp. Theo quy tắc, mọi thay đổi được gửi thông qua API Cập nhật gia tăng phải là thay đổi có hiệu lực trong vòng không quá một giờ. Nếu không cần phản ánh thay đổi ngay lập tức, bạn có thể sử dụng tính năng chuyển dữ liệu hàng loạt. Các bản cập nhật gia tăng được xử lý trong vòng không quá 5 phút.
Điều kiện tiên quyết
Bạn cần có các mục sau trước khi triển khai bản cập nhật gia tăng:
- Một tài khoản dịch vụ được tạo với vai trò người chỉnh sửa cho dự án Hành động của bạn. Để biết thêm thông tin chi tiết, hãy xem phần Tạo và thiết lập dự án.
- Nguồn cấp dữ liệu sản xuất hoặc hộp cát được lưu trữ và nhập. Để biết thêm thông tin chi tiết, hãy xem phần Quy trình truyền dẫn hàng loạt.
- (Không bắt buộc nhưng nên làm) Cài đặt Thư viện ứng dụng Google bằng ngôn ngữ bạn chọn để hỗ trợ việc sử dụng OAuth 2.0 khi gọi API. Các mã mẫu bên dưới sử dụng các thư viện này. Nếu không, bạn sẽ cần xử lý việc trao đổi mã thông báo theo cách thủ công như mô tả trong phần Sử dụng OAuth 2.0 để truy cập vào API của Google.
Điểm cuối
Trong các yêu cầu bên dưới, hãy thay thế nội dung sau:
- PROJECT_ID: Mã dự án trên Google Cloud được liên kết với dự án bạn tạo trong phần Tạo và thiết lập dự án.
- TYPE: Loại thực thể (thuộc tính
@type) của đối tượng trong nguồn cấp dữ liệu mà bạn muốn cập nhật. - ENTITY_ID (chỉ xoá điểm cuối): Mã nhận dạng của thực thể cần xoá. Hãy nhớ mã hoá URL cho mã nhận dạng thực thể.
- DELETE_TIME (chỉ xoá điểm cuối): Trường không bắt buộc để biểu thị thời điểm thực thể bị xoá trên hệ thống của bạn (mặc định là khi nhận được yêu cầu). Giá trị thời gian không được là thời gian trong tương lai. Khi gửi một thực thể thông qua lệnh gọi gia tăng, tạo phiên bản thực thể cũng sử dụng trường
delete_timetrong trường hợp lệnh gọi xoá. Định dạng giá trị này làyyyy-mm-ddTHH:mm:ssZ
Cập nhật điểm cuối
Để sửa đổi một thực thể, hãy tạo một yêu cầu POST HTTP đến điểm cuối sau và thêm tải trọng cập nhật và bổ sung. Bạn có thể cập nhật tối đa 1.000 thực thể trong một lệnh gọi API.
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities:batchPush
Ví dụ: nếu bạn muốn cập nhật các thực thể trong một dự án có mã nhận dạng "delivery-provider-id", thì điểm cuối sẽ là:
https://actions.googleapis.com/v2/apps/delivery-provider-id/entities:batchpush
Xoá điểm cuối
Để xoá một thực thể trong khoảng không quảng cáo, hãy tạo một yêu cầu XOÁ HTTP đến điểm cuối sau.
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME
Ví dụ: để xoá thực thể "MenuSection" có mã nhận dạng "menuSection_122" khỏi dự án "delivery-provider-id", bạn sẽ thực hiện lệnh gọi API XOÁ HTTP để:
https://actions.googleapis.com/v2/apps/delivery-provider-id/entities/MenuSection/menuSection_122?entity.vertical=FOODORDERING
Môi trường hộp cát
Để sử dụng API Cập nhật gia tăng trong khoảng không quảng cáo hộp cát, hãy làm theo hướng dẫn trong phần Điểm cuối ở trên, nhưng hãy gửi yêu cầu đến /v2/sandbox/apps/ thay vì /v2/apps/.
https://actions.googleapis.com/v2/sandbox/apps/PROJECT_ID/entities:batchPush
https://actions.googleapis.com/v2/sandbox/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME
Cập nhật thực thể
Mỗi yêu cầu POST phải bao gồm các tham số yêu cầu cùng với tải trọng JSON chứa dữ liệu có cấu trúc của bất kỳ loại thực thể nào được liệt kê trong giản đồ khoảng không quảng cáo.
Cập nhật tải trọng
JSON sẽ xuất hiện giống như trong nguồn cấp dữ liệu theo lô, với những điểm khác biệt sau:
- Kích thước nội dung tải trọng không được vượt quá 5 MB. Tương tự như nguồn cấp dữ liệu hàng loạt, bạn nên xoá khoảng trắng để phù hợp với nhiều dữ liệu hơn.
- Phong bì như sau:
{ "requests": [ { "entity": { "data":"ENTITY_DATA", "name": "apps/project_id>/entities/type/entity_id" }, "update_time":"UPDATE_TIMESTAMP" }, ], "vertical": "FOODORDERING" }
Trong tải trọng trên, hãy thay thế nội dung sau:
- ENTITY_DATA: Thực thể ở định dạng JSON được chuyển đổi tuần tự dưới dạng chuỗi. Bạn phải truyền thực thể JSON-LD dưới dạng chuỗi trong trường
data. - UPDATE_TIMESTAMP (không bắt buộc): Dấu thời gian khi thực thể được cập nhật trong hệ thống của bạn. Giá trị thời gian không được là thời gian trong tương lai. Dấu thời gian mặc định là thời điểm Google nhận được yêu cầu. Khi gửi một thực thể thông qua yêu cầu tăng dần, tính năng phân cấp phiên bản thực thể cũng sử dụng trường
update_timetrong trường hợp yêu cầu thêm/cập nhật.
Ví dụ
Ví dụ 1: Cập nhật nhà hàng
Giả sử bạn cần cập nhật gấp số điện thoại của một nhà hàng. Nội dung cập nhật của bạn chứa JSON cho toàn bộ nhà hàng.
Hãy xem xét một nguồn cấp dữ liệu theo lô có dạng như sau:
{ "@type": "Restaurant", "@id": "restaurant12345", "name": "Some Restaurant", "url": "https://www.provider.com/somerestaurant", "telephone": "+16501234567", "streetAddress": "345 Spear St", "addressLocality": "San Francisco", "addressRegion": "CA", "postalCode": "94105", "addressCountry": "US", "latitude": 37.472842, "longitude": -122.217144 }
Sau đó, nội dung cập nhật gia tăng của bạn bằng HTTP POST sẽ như sau:
POST v2/sandbox/apps/provider-project/entities:batchPush Host: actions.googleapis.com Content-Type: application/ld+json { "requests": [ { "entity": { "name": "apps/provider-project/entities/restaurant/restaurant12345", "data": { "@type": "Restaurant", "@id": "restaurant12345", "name": "Some Restaurant", "url": "https://www.provider.com/somerestaurant", "telephone": "+16501235555", "streetAddress": "345 Spear St", "addressLocality": "San Francisco", "addressRegion": "CA", "postalCode": "94105", "addressCountry": "US", "latitude": 37.472842, "longitude": -122.217144 } } } "vertical": "FOODORDERING" }
Ví dụ 2: Cập nhật nhiều nhà hàng
Để cập nhật hai thực thể nhà hàng trong một lệnh gọi API, yêu cầu POST HTTP sẽ như sau:
POST v2/sandbox/apps/provider-project/entities:batchPush Host: actions.googleapis.com Content-Type: application/ld+json { "requests": [ { "entity": { "name": "apps/provider-project/entities/restaurant/restaurant12345", "data": { "@type": "Restaurant", "@id": "restaurant12345", "name": "Some Restaurant", "url": "https://www.provider.com/somerestaurant", "telephone": "+16501235555", "streetAddress": "345 Spear St", "addressLocality": "San Francisco", "addressRegion": "CA", "postalCode": "94105", "addressCountry": "US", "latitude": 37.472842, "longitude": -122.217144 } } }, { "entity": { "name": "apps/provider-project/entities/restaurant/restaurant123", "data": { "@type": "Restaurant", "@id": "restaurant123", "name": "Some Other Restaurant", "url": "https://www.provider.com/somerestaurant", "telephone": "+16501231235", "streetAddress": "385 Spear St", "addressLocality": "San Mateo", "addressRegion": "CA", "postalCode": "94115", "addressCountry": "US" } } } ] "vertical": "FOODORDERING" }
Ví dụ 3: Cập nhật giá của một món ăn
Giả sử bạn cần thay đổi giá của một món trong thực đơn. Như trong Ví dụ 1, nội dung cập nhật của bạn phải chứa JSON cho toàn bộ thực thể cấp cao nhất (trình đơn) và nguồn cấp dữ liệu sử dụng giản đồ khoảng không quảng cáo v1.
Hãy xem xét một nguồn cấp dữ liệu theo lô có dạng như sau:
{ "@type": "MenuItemOffer", "@id": "menuitemoffer6680262", "sku": "offer-cola", "menuItemId": "menuitem896532", "price": 3.00, "priceCurrency": "USD" }
Sau đó, nội dung cập nhật gia tăng của bạn qua POST sẽ như sau:
POST v2/sandbox/apps/provider-project/entities:batchPush Host: actions.googleapis.com Content-Type: application/ld+json { "requests": [ { "entity": { "name": "apps/provider-project/entities/menuitemoffer/menuitemoffer6680262", "data": { "@type": "MenuItemOffer", "@id": "menuitemoffer6680262", "sku": "offer-cola", "menuItemId": "menuitem896532", "price": 1.00, "priceCurrency": "USD" }, "vertical": "FOODORDERING" } } ] "vertical": "FOODORDERING" }
Thêm thực thể
Để thêm thực thể, hãy tránh sử dụng tính năng cập nhật khoảng không quảng cáo. Thay vào đó, hãy sử dụng quy trình nguồn cấp dữ liệu theo lô như mô tả cho giản đồ khoảng không quảng cáo phiên bản 2.
Xoá thực thể
Để xoá các thực thể cấp cao nhất, bạn sử dụng một điểm cuối được sửa đổi một chút và sử dụng HTTP DELETE thay vì HTTP POST trong yêu cầu.
Xoá thực thể cấp cao nhất
Hãy xem xét trường hợp bạn muốn xoá một nhà hàng trong nguồn cấp dữ liệu. Bạn cũng phải xoá các dịch vụ và trình đơn của trang web đó.
Điểm cuối mẫu cho một thực thể thực đơn có mã nhận dạng "provider/restaurant/menu/nr":
DELETE v2/apps/delivery-provider-id/entities/menu/provider%2Frestaurant%2Fmenu%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
Điểm cuối mẫu cho một thực thể nhà hàng có mã nhận dạng "https://www.provider.com/restaurant/nr":
DELETE v2/apps/delivery-provider-id/entities/restaurant/provider%2Frestaurant%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
Điểm cuối mẫu cho một thực thể dịch vụ có mã nhận dạng "https://www.provider.com/restaurant/service/nr":
DELETE v2/apps/delivery-provider-id/entities/service/provider%2Frestaurant%2Fservice%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
}
Xoá thực thể phụ
Đừng sử dụng HTTP DELETE để xoá một thực thể con trong một thực thể cấp cao nhất, chẳng hạn như một mục trong trình đơn. Thay vào đó, hãy coi việc xoá các thực thể phụ là một bản cập nhật cho một thực thể cấp cao nhất, trong đó thực thể phụ bị xoá khỏi danh sách có liên quan hoặc reverseReference.
Mã phản hồi API
Lệnh gọi thành công không có nghĩa là nguồn cấp dữ liệu hợp lệ hoặc chính xác, mà chỉ là lệnh gọi API đã được thực hiện. Các lệnh gọi thành công sẽ nhận được mã phản hồi HTTP 200 cùng với nội dung phản hồi trống:
{}
Đối với các lỗi, mã phản hồi HTTP sẽ không phải là 200 và nội dung phản hồi sẽ cho biết lỗi xảy ra.
Ví dụ: nếu người dùng đã đặt giá trị "vertical" (dọc) trong phong bì thành FAKE_VERTICAL, bạn sẽ nhận được thông báo bên dưới:
{
"error": {
"code": 400,
"message": "Invalid value at 'entity.vertical' (TYPE_ENUM), \"FAKE_VERTICAL\"",
"status": "INVALID_ARGUMENT",
"details": [
{
"@type": "type.googleapis.com/google.rpc.BadRequest",
"fieldViolations": [
{
"field": "entity.vertical",
"description": "Invalid value at 'entity.vertical' (TYPE_ENUM), \"FAKE_VERTICAL\""
}
]
}
]
}
}
Mã mẫu
Dưới đây là một số mẫu về cách sử dụng API Cập nhật gia tăng bằng nhiều ngôn ngữ. Các mẫu này sử dụng Thư viện xác thực của Google và giả định một nguồn cấp dữ liệu sử dụng giản đồ khoảng không quảng cáo v1. Để biết các giải pháp thay thế, hãy tham khảo bài viết Sử dụng OAuth 2.0 cho ứng dụng từ máy chủ đến máy chủ.
Cập nhật thực thể
Node.js
Mã này sử dụng thư viện xác thực của Google cho Node.js.
const {auth} = require('google-auth-library') const request = require('request'); // The service account client secret file downloaded from the Google Cloud Console const serviceAccountJson = require('./service-account.json') // entity.json is a file that contains the entity data in json format const entity = require('./entity.json') const ENTITY_ID = 'your/entity/id' const PROJECT_ID = 'type/your-project-id' /** * Get the authorization token using a service account. */ async function getAuthToken() { let client = auth.fromJSON(serviceAccountJson) client.scopes = ['https://www.googleapis.com/auth/assistant'] const tokens = await client.authorize() return tokens.access_token; } /** * Send an incremental update to update or add an entity */ async function updateEntity(entity) { const token = await getAuthToken() request.post({ headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, url: `https://actions.googleapis.com/v2/apps/${PROJECT_ID}/entities:batchPush`, body: { requests: [ { entity: { data: JSON.stringify(entity) name: `apps/${PROJECT_ID}/entities/${ENTITY_ID}` } } ], vertical: 'FOODORDERING' }, json: true }, (err, res, body) => { if (err) { return console.log(err); } console.log(`Response: ${JSON.stringify(res)}`) }) } updateEntity(entity)
Python
Mã này sử dụng thư viện xác thực của Google cho Python.
from google.oauth2 import service_account from google.auth.transport.requests import AuthorizedSession import json import urllib PROJECT_ID = 'your-project-id' ENTITY_ID = 'type/your/entity/id' ENDPOINT = 'https://actions.googleapis.com/v2/apps/%s/entities:batchPush' % ( PROJECT_ID) # service-account.json is the service account client secret file downloaded from the # Google Cloud Console credentials = service_account.Credentials.from_service_account_file( 'service-account.json') scoped_credentials = credentials.with_scopes( ['https://www.googleapis.com/auth/assistant']) authed_session = AuthorizedSession(scoped_credentials) # Retrieving the entity update_file = open("entity.json") #JSON file containing entity data in json format. data = update_file.read() entity = {} entity['data'] = data #entity JSON-LD serialized as string entity['name'] = 'apps/%s/entities/%s' % (PROJECT_ID, urllib.quote(ENTITY_ID, '') ) # Populating the request request = {} request['entity'] = entity requestArray = [request] # Populating the payload payload = {} payload['requests'] = requestArray payload['vertical'] = 'FOODORDERING' response = authed_session.post(ENDPOINT, json=payload) print(response.text) #if successful, will be '{}'
Java
Mã này sử dụng thư viện xác thực của Google cho Java.
private static final String PROJECT_ID = "your-project-id"; private static final String ENTITY_ID = "type/your-entity-id"; /** * Get the authorization token using a service account. */ private static String getAuthToken() { InputStream serviceAccountFile = Example.class.getClassLoader().getResourceAsStream("service-account.json"); ServiceAccountCredentials.Builder credentialsSimpleBuilder = ServiceAccountCredentials.fromStream(serviceAccountFile).toBuilder(); credentialsSimpleBuilder.setScopes(ImmutableList.of("https://www.googleapis.com/auth/assistant")); AccessToken accessToken = credentialsSimpleBuilder.build().refreshAccessToken(); return accessToken.getTokenValue(); } /** * Send an incremental update to update or add an entity. * @param entityId The id of the entity to update. * @param entity the json of the entity to be updated. */ public void updateEntity(String entityId, JSONObject data) { String authToken = getAuthToken(); String endpoint = String.format("https://actions.googleapis.com/v2/apps/%s/entities/:batchPush", PROJECT_ID); JSONObject entity = new JSONObject(); entity.put("data", data.toString()); entity.put("name", String.format("apps/%s/entities/%s", PROJECT_ID, URLEncoder.encode(ENTITY_ID, "UTF-8"))); JSONObject request = new JSONObject(); request.put("entity", entity); JSONArray requestArray = new JSONArray(); requestArray.put(request); JSONObject payload = new JSONObject(); payload.put("requests", requestArray); payload.put("vertical", FOODORDERING); // Execute POST request executePostRequest(endpoint, authToken, payload); }
Xoá thực thể
Node.js
Mã này sử dụng thư viện xác thực của Google cho Node.js.
const {auth} = require('google-auth-library') const request = require('request'); // The service account client secret file downloaded from the Google Cloud Console const serviceAccountJson = require('./service-account.json') // entity.json is a file that contains the entity data in json format const entity = require('./entity.json') const ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant' const PROJECT_ID = 'your-project-id' /** * Get the authorization token using a service account. */ async function getAuthToken() { let client = auth.fromJSON(serviceAccountJson) client.scopes = ['https://www.googleapis.com/auth/assistant'] const tokens = await client.authorize() return tokens.access_token; } /** * Send an incremental update to delete an entity */ async function deleteEntity(entityId) { const token = await getAuthToken() request.delete({ headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, url: `https://actions.googleapis.com/v2/apps/${PROJECT_ID}/entities/${encodeURIComponent(entityId)}?entity.vertical=FOODORDERING`, body: {}, json: true }, (err, res, body) => { if (err) { return console.log(err); } console.log(`Response: ${JSON.stringify(res)}`) }) } deleteEntity(ENTITY_ID)
Python
Mã này sử dụng thư viện xác thực của Google cho Python.
from google.oauth2 import service_account from google.auth.transport.requests import AuthorizedSession import json import urllib # Service config PROJECT_ID = 'your-project-id' ENTITY_ID = 'restaurant/http://www.provider.com/somerestaurant' DELETE_TIME = '2018-04-07T14:30:00-07:00' ENDPOINT = 'https://actions.googleapis.com/v2/apps/%s/entities/%s?entity.vertical=FOODORDERING&delete_time=%s' % ( PROJECT_ID, urllib.quote(ENTITY_ID, ''), urllib.quote(DELETE_TIME, '')) # service-account.json is the service account client secret file downloaded from the # Google Cloud Console credentials = service_account.Credentials.from_service_account_file( 'service-account.json') scoped_credentials = credentials.with_scopes( ['https://www.googleapis.com/auth/assistant']) authed_session = AuthorizedSession(scoped_credentials) response = authed_session.delete(ENDPOINT) print(response.text) #if successful, will be '{}'
Java
Mã này sử dụng thư viện xác thực của Google cho Java.
private static final String PROJECT_ID = "your-project-id"; private static final String ENTITY_ID = "restaurant/http://www.provider.com/somerestaurant"; /** * Get the authorization token using a service account. */ private static String getAuthToken() { InputStream serviceAccountFile = Example.class.getClassLoader().getResourceAsStream("service-account.json"); ServiceAccountCredentials.Builder credentialsSimpleBuilder = ServiceAccountCredentials.fromStream(serviceAccountFile).toBuilder(); credentialsSimpleBuilder.setScopes(ImmutableList.of("https://www.googleapis.com/auth/assistant")); AccessToken accessToken = credentialsSimpleBuilder.build().refreshAccessToken(); return accessToken.getTokenValue(); } /** * Send an incremental update to delete an entity. * @param entityId The id of the entity to delete. */ public void deleteEntity(String entityId) { String authToken = getAuthToken(); String endpoint = String.format( "https://actions.googleapis.com/v2/apps/%s/entities/%s?entity.vertical=FOODORDERING", PROJECT_ID, URLEncoder.encode(entityId, "UTF-8")); // Execute DELETE request System.out.println(executeDeleteRequest(endpoint, authToken)); }
Trường hợp sử dụng
Các trường hợp sử dụng sau đây là ví dụ về nội dung cập nhật gia tăng, nội dung cập nhật nguồn cấp dữ liệu đầy đủ và nội dung ở cấp cao trong lệnh gọi API:
| Trường hợp | Thực thể cần cập nhật | Nội dung mô tả và hiệu ứng |
|---|---|---|
| Tắt dịch vụ | Service |
Bạn cần tắt một dịch vụ vì lý do ngoài dự kiến. Cập nhật gia tăng: Cập nhật thực thể Nguồn cấp dữ liệu đầy đủ: Hãy nhớ cập nhật thực thể từ nguồn cấp dữ liệu đầy đủ để đặt |
| Mặt hàng cụ thể đã hết hàng | MenuItemOffer |
Cập nhật gia tăng: Gửi thực thể MenuItemOffer đóng gói với inventoryLevel được đặt thành 0 cho MenuItem đã cho và tất cả dữ liệu khác không thay đổi. |
| Thay đổi giá của món ăn trong thực đơn | MenuItemOffer |
Cập nhật tăng dần: Gửi thực thể MenuItemOffer đóng gói với price được đặt thành giá đã cập nhật cho MenuItem đã cho và tất cả dữ liệu khác không thay đổi. |
|
Thêm thực thể cấp cao nhất mới Chỉ áp dụng cho thực thể thuộc loại |
Menu, Restaurant, Service |
Ví dụ: bạn cần thêm một thực đơn mới vào nhà hàng. Nguồn cấp dữ liệu đầy đủ: Thêm thực thể vào nguồn cấp dữ liệu và đợi quá trình truyền dẫn hàng loạt. |
|
Xoá vĩnh viễn thực thể cấp cao nhất Chỉ áp dụng cho thực thể thuộc loại |
Menu, Restaurant, Service |
Bản cập nhật gia tăng: Gửi một lệnh xoá rõ ràng. Nguồn cấp dữ liệu đầy đủ: Hãy nhớ xoá thực thể khỏi nguồn cấp dữ liệu đầy đủ trước lần tìm nạp tiếp theo của Google, nếu không, thực thể sẽ được thêm lại. |
Thêm khu vực phân phối mới trong một Service cụ thể |
ServiceArea |
Nguồn cấp dữ liệu gia tăng: Gửi thực thể ServiceArea có liên quan với tất cả các trường nguyên vẹn, như bạn thường làm trong nguồn cấp dữ liệu đầy đủ, với khu vực phân phối mới được chỉ định trong polygon, geoRadius hoặc postalCode. |
Cập nhật thời gian giao hàng dự kiến trong Service |
ServiceHours |
Nguồn cấp dữ liệu tăng dần: Gửi ServiceHours giống như trong nguồn cấp dữ liệu, ngoại trừ leadTimeMin được cập nhật tương ứng. |
Cập nhật giá giao hàng trong Service |
Fee |
Nguồn cấp dữ liệu gia tăng: Gửi Fee phân phối đầy đủ với price đã cập nhật. |
Cập nhật giờ giao hàng hoặc giờ bán mang đi trong Service |
ServiceHours |
Nguồn cấp dữ liệu tăng dần: Gửi ServiceHours giống như trong nguồn cấp dữ liệu, ngoại trừ các thuộc tính opens và closes được cập nhật tương ứng. |
Service (thay đổi số lượng đơn đặt hàng tối thiểu) |
Fee |
Nguồn cấp dữ liệu gia tăng: Gửi Fee đầy đủ với minPrice đã cập nhật |
Xoá MenuItem vĩnh viễn |
Menu |
Nguồn cấp dữ liệu tăng dần: Gửi MenuItem giống như trong nguồn cấp dữ liệu, nhưng parentMenuSectionId trống.
|
Mức độ cung cấp dịch vụ về thời gian xử lý cho các công việc theo lô và bản cập nhật gia tăng
Một thực thể được cập nhật hoặc xoá thông qua một lô sẽ được xử lý trong vòng 2 giờ ở chế độ nỗ lực tối đa, trong khi một thực thể được cập nhật thông qua một bản cập nhật gia tăng sẽ được xử lý trong 5 phút. Một thực thể cũ sẽ bị xoá sau 7 ngày.
Bạn có thể gửi cho Google:
- Nhiều công việc theo lô mỗi ngày để luôn cập nhật kho hàng, HOẶC
- Một công việc hàng loạt mỗi ngày và API gia tăng để luôn cập nhật kho hàng.