ส่วนนี้อธิบายวิธีส่งการอัปเดตที่มีเวลาเป็นปัจจัยสำคัญของฟีดให้กับ Google API การอัปเดตที่เพิ่มขึ้นทำให้คุณสามารถอัปเดตและลบเอนทิตีใน ฟีดได้แทบจะเรียลไทม์
ฟังก์ชันการทำงานนี้มีจุดประสงค์หลักสำหรับการอัปเดตที่คุณคาดไม่ถึง เช่น การปิดฉุกเฉิน ตามกฎแล้ว การเปลี่ยนแปลงใดๆ ที่ส่งผ่าน API การอัปเดตส่วนเพิ่มควรเป็นการเปลี่ยนแปลงที่ต้องใช้งานภายในไม่เกิน 1 สัปดาห์ ถ้าไม่จำเป็นต้องแสดงการเปลี่ยนแปลงโดยทันที คุณสามารถใช้ การอัปเดตเป็นกลุ่มแทน ระบบจะประมวลผลการอัปเดตเพิ่มเติมไม่เกิน 5 รายการ นาที
ตั้งค่า
สำหรับการติดตั้งใช้งานอัปเดตแบบค่อยเป็นค่อยไป ให้ปฏิบัติดังนี้
- ทำตามขั้นตอนที่ระบุไว้ในหัวข้อสร้างและตั้งค่าโปรเจ็กต์เพื่อ สร้างโปรเจ็กต์
- ทำตามขั้นตอนที่ระบุไว้ในหัวข้อสร้างบัญชีบริการ เพื่อสร้างบัญชีบริการ โปรดทราบว่าคุณต้องเป็น "เจ้าของ" ของ โปรเจ็กต์เพื่อเพิ่ม "ผู้แก้ไข" บทบาทสำหรับบัญชีบริการ
- (ไม่บังคับ แต่แนะนำ) ติดตั้งไลบรารีของไคลเอ็นต์ Google ในภาษาที่คุณเลือกเพื่อให้สะดวกในการใช้ OAuth 2.0 เมื่อเรียกใช้ API ตัวอย่างโค้ดที่รวมอยู่ด้านล่างใช้ไลบรารีเหล่านี้ มิฉะนั้น ต้องจัดการการแลกเปลี่ยนโทเค็นด้วยตนเองตามที่อธิบายไว้ในการใช้ OAuth 2.0 เพื่อเข้าถึง Google API
ปลายทาง
หากต้องการแจ้งให้ Google ทราบเกี่ยวกับการอัปเดต ให้ส่งคำขอ HTTP POST ไปยังส่วนเพิ่ม อัปเดต API และมีเพย์โหลดของการอัปเดตและการเพิ่ม สคีมาพื้นที่โฆษณาที่คุณใช้จะเป็นตัวกำหนดปลายทางที่จะส่งคำขอ ดังนี้
พื้นที่โฆษณาเวอร์ชัน 2
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/TYPE/ENTITY_ID:push
พื้นที่โฆษณา v1
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/ENTITY_ID:push
หากต้องการนำเอนทิตีออก ให้ส่งคำขอ HTTP DELETE ไปยังปลายทางต่อไปนี้ สอดคล้องกับสคีมาพื้นที่โฆษณาที่คุณใช้
พื้นที่โฆษณาเวอร์ชัน 2
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME
พื้นที่โฆษณา v1
https://actions.googleapis.com/v2/apps/PROJECT_ID/entities/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME
ในคำขอข้างต้น ให้ใส่ข้อมูลต่อไปนี้
- PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับโปรเจ็กต์ที่คุณ สร้างในส่วนสร้างและตั้งค่าโปรเจ็กต์
- TYPE (สคีมาพื้นที่โฆษณา V2 เท่านั้น): ประเภทเอนทิตี (พร็อพเพอร์ตี้
@type
) ของออบเจ็กต์ในฟีดข้อมูลที่ต้องการอัปเดต - ENTITY_ID: รหัสของเอนทิตีที่รวมอยู่ในเพย์โหลด อย่าลืม เข้ารหัส URL เอนทิตี
- DELETE_TIME (ลบปลายทางเท่านั้น): ช่องที่ไม่บังคับเพื่อใช้ระบุ
เวลาที่ลบเอนทิตีในระบบ (ค่าเริ่มต้นคือเวลาที่คำขอคือ
ได้รับ) ค่าของเวลาต้องไม่เป็นเวลาในอนาคต เมื่อส่งเอนทิตี
ผ่านการเรียกที่เพิ่มขึ้น การกำหนดเวอร์ชันเอนทิตี
ยังใช้ช่อง
delete_time
ในกรณีที่เป็นการโทรแบบลบด้วย จัดรูปแบบ ค่าเป็นyyyy-mm-ddTHH:mm:ssZ
เช่น คุณมีโปรเจ็กต์ที่มีรหัส "delivery-provider-id" ซึ่งใช้ สคีมาพื้นที่โฆษณาเวอร์ชัน 2 คุณต้องการเปลี่ยนแปลงข้อมูลกับร้านอาหารด้วย ประเภทเอนทิตีร้านอาหารของ "MenuSection" และรหัสเอนทิตีของ "menuSection_122" จุดสิ้นสุดสำหรับการอัปเดตข้อมูลจะเป็นดังนี้
https://actions.googleapis.com/v2/apps/delivery-provider-id/entities/MenuSection/menuSection_122:push
หากต้องการนำเอนทิตีเดียวกันนี้ออก คุณจะต้องเรียก HTTP DELETE API ต่อไปนี้
https://actions.googleapis.com/v2/apps/delivery-provider-id/entities/MenuSection/menuSection_122?entity.vertical=FOODORDERING
คำขอแซนด์บ็อกซ์
สำหรับคำขอแซนด์บ็อกซ์ โปรดทำตามคำแนะนำในปลายทางข้างต้น แต่
ส่งคำขอไปยัง /v2/sandbox/apps/
แทนที่จะเป็น /v2/apps/
ตัวอย่างเช่น
คำขอลบแซนด์บ็อกซ์สำหรับสคีมาพื้นที่โฆษณาเวอร์ชัน 2 มีโครงสร้างดังนี้
https://actions.googleapis.com/v2/sandbox/apps/PROJECT_ID/entities/TYPE/ENTITY_ID?entity.vertical=FOODORDERING&delete_time=DELETE_TIME
การอัปเดตและการเพิ่ม
ฟีดแบบกลุ่มรายวันควรมีการเปลี่ยนแปลงที่ส่งผ่าน API มิฉะนั้น การอัปเดตเป็นกลุ่มจะเขียนทับการเปลี่ยนแปลงที่เพิ่มขึ้น
เพย์โหลด
คำขอ POST แต่ละรายการต้องมีพารามิเตอร์คำขอควบคู่ไปกับ JSON เพย์โหลดที่มีข้อมูลที่มีโครงสร้างของเอนทิตีประเภทใดก็ได้ที่แสดงใน ของพื้นที่โฆษณา
JSON ควรปรากฏแบบเดียวกันกับที่ปรากฏในฟีดแบบกลุ่มโดยมี ความแตกต่างดังต่อไปนี้
- เนื้อหาเพย์โหลดควรมีขนาดไม่เกิน 5 MB คล้ายกับกลุ่ม เราขอแนะนำให้คุณตัดช่องว่างออกเพื่อใส่ข้อมูลเพิ่มเติม
- ซองจดหมายมีลักษณะดังนี้
{ "entity": { "data":"ENTITY_DATA", "vertical":"FOODORDERING" }, "update_time":"UPDATE_TIMESTAMP" }
แทนที่รายการต่อไปนี้ในเพย์โหลดด้านบน
- ENTITY_DATA: เอนทิตีในรูปแบบ JSON ที่เรียงลำดับเป็นสตริง
ต้องส่งเอนทิตี JSON-LD เป็นสตริงในช่อง
data
- UPDATE_TIMESTAMP (ไม่บังคับ): การประทับเวลาเมื่ออัปเดตเอนทิตีใน
ระบบของคุณ ค่าของเวลาต้องไม่เป็นเวลาในอนาคต การประทับเวลาเริ่มต้นคือเมื่อ
Google จะได้รับคําขอ เมื่อส่งเอนทิตีผ่านการเพิ่ม
นอกจากนี้ การกำหนดเวอร์ชันเอนทิตียังใช้
update_time
ในกรณีที่เป็นคำขอเพิ่ม/อัปเดต
การอัปเดตเอนทิตี
ตัวอย่างที่ 1: การอัปเดตร้านอาหาร
สมมติว่าคุณจำเป็นต้องอัปเดตหมายเลขโทรศัพท์ของร้านอาหารอย่างเร่งด่วน บัญชี อัปเดตมี JSON สำหรับร้านอาหารทั้งหมด
ลองใช้ฟีดแบบกลุ่มที่มีลักษณะดังต่อไปนี้
{ "@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 }
การอัปเดตที่เพิ่มขึ้นจาก HTTP POST จะมีลักษณะดังนี้
POST v2/apps/provider-project/entities/Restaurant/restaurant12345:push Host: actions.googleapis.com Content-Type: application/ld+json { "entity": { "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" } }
ตัวอย่างที่ 2: การอัปเดตราคาของรายการในเมนู
สมมติว่าคุณต้องการเปลี่ยนแปลงราคาของรายการในเมนู ตามตัวอย่างที่ 1 การอัปเดตต้องมี JSON สำหรับเอนทิตีระดับบนสุดทั้งหมด (เมนู) และ ฟีดจะใช้สคีมาพื้นที่โฆษณา v1
ลองใช้ฟีดแบบกลุ่มที่มีลักษณะดังต่อไปนี้
{ "@type": "MenuItemOffer", "@id": "menuitemoffer6680262", "sku": "offer-cola", "menuItemId": "menuitem896532", "price": 3.00, "priceCurrency": "USD" }
การอัปเดตที่เพิ่มขึ้นผ่าน POST จะเป็นดังนี้
POST v2/apps/provider-project/entities/MenuItemOffer/menuitemoffer6680262:push Host: actions.googleapis.com Content-Type: application/ld+json { "entity": { "data": { "@type": "MenuItemOffer", "@id": "menuitemoffer6680262", "sku": "offer-cola", "menuItemId": "menuitem896532", "price": 1.00, "priceCurrency": "USD" }, "vertical": "FOODORDERING" } }
การเพิ่มเอนทิตี
หากต้องการเพิ่มเอนทิตี โปรดหลีกเลี่ยงการใช้การอัปเดตสินค้าคงคลัง ให้ใช้ฟีดแบบกลุ่มแทน ตามที่อธิบายไว้สำหรับสคีมาพื้นที่โฆษณาเวอร์ชัน 2
การนำเอนทิตีออก
หากต้องการนำเอนทิตีระดับบนสุดออก ให้ใช้ปลายทางที่มีการแก้ไขเล็กน้อย และใช้ HTTP DELETE แทน HTTP POST ในคำขอ
อย่าใช้ HTTP DELETE เพื่อนำเอนทิตีย่อยภายในเอนทิตีระดับบนสุดออก เช่น รายการในเมนูภายในเมนู แต่ให้ถือว่าการลบเอนทิตีย่อยเป็น การอัปเดตเป็นเอนทิตีระดับบนสุดซึ่งเอนทิตีย่อยถูกนำออกจาก รายการหรือพารามิเตอร์ที่เกี่ยวข้อง
ตัวอย่างที่ 1: การลบเอนทิตีระดับบนสุด
ลองพิจารณาสถานการณ์ที่คุณต้องการลบร้านอาหารในฟีดที่ใช้ สคีมาพื้นที่โฆษณา v1 และคุณต้องลบบริการและเมนูออกด้วย
ตัวอย่างปลายทางสำหรับเอนทิตีเมนูที่มีรหัส "https://www.provider.com/restaurant/menu/nr":
DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fmenu%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
ตัวอย่างปลายทางสำหรับเอนทิตีร้านอาหารที่มีรหัส "https://www.provider.com/restaurant/nr":
DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
ตัวอย่างปลายทางสำหรับเอนทิตีบริการที่มีรหัส "https://www.provider.com/restaurant/service/nr":
DELETE v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fservice%2Fnr?entity.vertical=FOODORDERING
Host: actions.googleapis.com
}
ตัวอย่างที่ 2: การนำเอนทิตีย่อยออก
หากต้องการนำเอนทิตีย่อยออกจากเอนทิตีระดับบนสุด คุณต้องส่งเอนทิตีระดับบนสุด เอนทิตีที่นําเอนทิตีย่อยออกจากฟิลด์ที่เกี่ยวข้อง ดังต่อไปนี้ ตัวอย่างเช่น จะถือว่าฟีดใช้สคีมาพื้นที่โฆษณา v1
เช่น หากต้องการนำพื้นที่ให้บริการออก ให้อัปเดตบริการด้วยพื้นที่ให้บริการ
นำออกจากรายการ areaServed
แล้ว
POST v2/apps/delivery-provider-id/entities/https%3A%2F%2Fwww.provider.com%2Frestaurant%2Fservice%2Fnr:push
Host: actions.googleapis.com
Content-Type: application/ld+json
{
"entity": {
// Note: "data" is not serialized as a string in our example for readability.
"data": {
"@type": "Service",
"provider": {
"@type": "Restaurant",
"@id": "https://www.provider.com/restaurant/nr"
},
"areaServed": [
{
"@type": "GeoCircle",
"geoMidpoint": {
"@type": "GeoCoordinates",
"latitude": "42.362757",
"longitude": "-71.087109"
},
"geoRadius": "10000"
}
// area2 is removed.
]
...
},
"vertical": "FOODORDERING"
}
}
โค้ดตอบกลับของ API
การเรียกที่ประสบความสำเร็จไม่ได้หมายความว่าฟีดนั้นถูกต้องหรือถูกต้อง แต่มีเพียง มีการเรียก API การเรียกใช้ที่สำเร็จจะได้รับรหัสตอบกลับ HTTP 200 พร้อมด้วย ที่มีเนื้อหาการตอบกลับว่างเปล่า:
{}
สำหรับความล้มเหลว โค้ดตอบกลับ HTTP จะไม่ใช่ 200 และเนื้อหาการตอบสนอง เพื่อระบุว่ามีอะไรผิดพลาด
ตัวอย่างเช่น หากผู้ใช้ตั้งค่า "ประเภทธุรกิจ" ในซองจดหมายเป็น
FAKE_VERTICAL
คุณจะได้รับข้อความด้านล่างนี้
{
"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\""
}
]
}
]
}
}
ตัวอย่างโค้ด
ด้านล่างนี้เป็นตัวอย่างวิธีใช้ API การอัปเดตที่เพิ่มขึ้นใน ภาษา ตัวอย่างเหล่านี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google และจะถือว่าฟีดโดยใช้ สคีมาพื้นที่โฆษณา v1 สำหรับโซลูชันทางเลือก โปรดดูที่ การใช้ OAuth 2.0 สำหรับแอปพลิเคชันระหว่างเซิร์ฟเวอร์กับเซิร์ฟเวอร์
การอัปเดตเอนทิตี
Node.js
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ 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 update or add an entity */ async function updateEntity(entityId, 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/${encodeURIComponent(entityId)}:push`, body: { entity: { data: JSON.stringify(entity), vertical: 'FOODORDERING', } }, json: true }, (err, res, body) => { if (err) { return console.log(err); } console.log(`Response: ${JSON.stringify(res)}`) }) } updateEntity(ENTITY_ID, entity)
Python
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ 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 = 'restaurant/http://www.provider.com/somerestaurant' ENDPOINT = 'https://actions.googleapis.com/v2/apps/%s/entities/%s:push' % ( PROJECT_ID, urllib.quote(ENTITY_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() # Populating the entity with wrapper entity = {} entity['data'] = data #entity JSON-LD serialized as string entity['vertical'] = 'FOODORDERING' request = {} request['entity'] = entity response = authed_session.post(ENDPOINT, json=request) print(response.text) #if successful, will be '{}'
Java
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ Java
private static final String PROJECT_ID = "your-project-id"; private static final String ENTITY_ID = "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 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 entity) { String authToken = getAuthToken(); String endpoint = String.format( "https://actions.googleapis.com/v2/apps/%s/entities/%s:push", PROJECT_ID, URLEncoder.encode(entityId, "UTF-8")); JSONObject data = new JSONObject(); data.put("data", entity.toString()); data.put("vertical", "FOODORDERING"); JSONObject jsonBody = new JSONObject(); jsonBody.put("entity", data); // Execute POST request executePostRequest(endpoint, authToken, jsonBody); }
การนำเอนทิตีออก
Node.js
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ 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
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ 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
โค้ดนี้ใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ 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)); }
กรณีการใช้งาน
ต่อไปนี้เป็นตัวอย่างการอัปเดตที่เพิ่มขึ้น การอัปเดตฟีดแบบสมบูรณ์ และเนื้อหาในระดับสูงในการเรียก API
สถานการณ์ | เอนทิตีระดับบนสุด | คำอธิบายและเอฟเฟกต์ |
---|---|---|
การปิดใช้บริการ | DisabledService |
คุณต้องปิดใช้บริการด้วยเหตุผลที่ไม่คาดคิด การอัปเดตที่เพิ่มขึ้น: ส่งเอนทิตี ฟีดแบบสมบูรณ์: อัปเดตเอนทิตีจากฟีดที่สมบูรณ์
ให้ตั้งค่า |
สินค้าที่เฉพาะเจาะจงหมดสต็อก | Menu |
การอัปเดตที่เพิ่มขึ้น: ส่ง Menu สรุป
ตั้งค่าเอนทิตีที่มี offer.inventoryLevel เป็น 0 สำหรับ
MenuItem และข้อมูลอื่นๆ ทั้งหมดไม่เปลี่ยนแปลง |
การเปลี่ยนแปลงราคาของรายการในเมนู | Menu |
การอัปเดตที่เพิ่มขึ้น: ส่ง Menu สรุป
ตั้งค่าเอนทิตีที่มี offer.price เป็นราคาที่อัปเดตแล้วสำหรับ
MenuItem และข้อมูลอื่นๆ ทั้งหมดไม่เปลี่ยนแปลง |
เพิ่มเอนทิตีระดับบนสุดใหม่ ใช้ได้กับเอนทิตีประเภท |
Menu , Restaurant , Service |
เช่น คุณต้องเพิ่มเมนูใหม่ให้ร้านอาหาร การอัปเดตเพิ่มเติม: ส่งเอนทิตีเมนูใหม่พร้อมกับร้านอาหาร
เอนทิตีที่มีฟิลด์ |
ลบเอนทิตีระดับบนสุดอย่างถาวร ใช้ได้กับเอนทิตีประเภท |
Menu , Restaurant , Service |
การอัปเดตที่เพิ่มขึ้น: ส่ง อาจลบอย่างชัดแจ้ง ฟีดแบบสมบูรณ์: ตรวจสอบว่าได้นําเอนทิตีออกจากฟีดแบบสมบูรณ์ก่อน การดึงข้อมูลครั้งต่อไปโดย Google มิฉะนั้นระบบจะเพิ่มเอนทิตีอีกครั้ง |
เพิ่มพื้นที่นำส่งใหม่ในพื้นที่ที่เฉพาะเจาะจงService |
Service |
ฟีดที่เพิ่มขึ้น: ส่งเอนทิตี Service ที่เป็นปัญหาพร้อมเอนทิตีทั้งหมด
ยังเหมือนเดิม เช่นเดียวกับที่คุณทำตามปกติภายในฟีดแบบเต็ม โดยมีพื้นที่นำส่งใหม่
ที่ระบุภายใน areaServed ของ Service |
อัปเดตเวลาถึงโดยประมาณที่นำส่งใน Service |
Service |
ฟีดที่เพิ่มขึ้น: ส่ง Service เหมือนกับ
อัปเดตฟีดแล้ว ยกเว้น hoursAvailable.deliveryHours
ตามนั้น |
อัปเดตราคาการจัดส่งเป็นสกุลเงิน Service |
Service |
ฟีดที่เพิ่มขึ้น: ส่ง Service แบบเต็มด้วย
อัปเดต offers.priceSpecification.price แล้ว |
อัปเดตเวลาจัดส่งหรือสั่งกลับบ้านใน Service |
Service |
ฟีดที่เพิ่มขึ้น: ส่ง Service เหมือนกับ
อัปเดตฟีดแล้ว ยกเว้น hoursAvailable
ตามนั้น |
Service (เปลี่ยนจำนวนการสั่งซื้อขั้นต่ำ) |
Service |
ฟีดที่เพิ่มขึ้น: ส่ง Service แบบเต็มด้วย
Service.offers.priceSpecification.eligibleTransactionVolume
อัปเดตแล้ว |
ลบ MenuItem อย่างถาวร |
Menu |
ฟีดที่เพิ่มขึ้น: ส่ง Menu เหมือนกับ
แต่มีการนำ MenuItem นี้ออกจาก
รายการ hasMenuItems |
SLO เกี่ยวกับเวลาในการประมวลผลสำหรับงานแบบกลุ่มและการอัปเดตที่เพิ่มขึ้น
เอนทิตีที่เพิ่มผ่านกลุ่มหรือการอัปเดตที่เพิ่มขึ้นจะได้รับการประมวลผลใน 1-2 วัน เอนทิตีที่อัปเดตหรือลบผ่านกลุ่มจะได้รับการประมวลผลใน 2 ชั่วโมงที่ระบบจะประมวลผลเอนทิตีที่อัปเดตผ่านการอัปเดตที่เพิ่มขึ้น ใน 5 นาที เอนทิตีที่ไม่มีอัปเดตจะถูกลบใน 7 วัน
คุณจะส่งสิ่งต่อไปนี้ให้ Google ก็ได้
- งานแบบกลุ่มหลายงานต่อวันเพื่อให้สินค้าคงคลังอัปเดตอยู่เสมอ หรือ
- งานแบบกลุ่ม 1 งานต่อวันและ API ที่เพิ่มขึ้นเพื่อให้สินค้าคงคลังของคุณเป็นปัจจุบัน