การอัปเดตพื้นที่โฆษณาที่เพิ่มขึ้น v1

ส่วนนี้อธิบายวิธีส่งการอัปเดตที่มีเวลาเป็นปัจจัยสำคัญของฟีดให้กับ Google API การอัปเดตที่เพิ่มขึ้นทำให้คุณสามารถอัปเดตและลบเอนทิตีใน ฟีดได้แทบจะเรียลไทม์

ฟังก์ชันการทำงานนี้มีจุดประสงค์หลักสำหรับการอัปเดตที่คุณคาดไม่ถึง เช่น การปิดฉุกเฉิน ตามกฎแล้ว การเปลี่ยนแปลงใดๆ ที่ส่งผ่าน API การอัปเดตส่วนเพิ่มควรเป็นการเปลี่ยนแปลงที่ต้องใช้งานภายในไม่เกิน 1 สัปดาห์ ถ้าไม่จำเป็นต้องแสดงการเปลี่ยนแปลงโดยทันที คุณสามารถใช้ การอัปเดตเป็นกลุ่มแทน ระบบจะประมวลผลการอัปเดตเพิ่มเติมไม่เกิน 5 รายการ นาที

ตั้งค่า

สำหรับการติดตั้งใช้งานอัปเดตแบบค่อยเป็นค่อยไป ให้ปฏิบัติดังนี้

  1. ทำตามขั้นตอนที่ระบุไว้ในหัวข้อสร้างและตั้งค่าโปรเจ็กต์เพื่อ สร้างโปรเจ็กต์
  2. ทำตามขั้นตอนที่ระบุไว้ในหัวข้อสร้างบัญชีบริการ เพื่อสร้างบัญชีบริการ โปรดทราบว่าคุณต้องเป็น "เจ้าของ" ของ โปรเจ็กต์เพื่อเพิ่ม "ผู้แก้ไข" บทบาทสำหรับบัญชีบริการ
  3. (ไม่บังคับ แต่แนะนำ) ติดตั้งไลบรารีของไคลเอ็นต์ 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

คุณต้องปิดใช้บริการด้วยเหตุผลที่ไม่คาดคิด

การอัปเดตที่เพิ่มขึ้น: ส่งเอนทิตี Service ใน เปลี่ยนคำถามที่มี @type เป็น DisabledService แต่คงพร็อพเพอร์ตี้อื่นๆ ไว้เหมือนเดิม

ฟีดแบบสมบูรณ์: อัปเดตเอนทิตีจากฟีดที่สมบูรณ์ ให้ตั้งค่า @type เป็น DisabledService ก่อน การดึงข้อมูลครั้งต่อไปโดย Google ไม่เช่นนั้นเอนทิตีจะเปิดใช้อีกครั้ง

สินค้าที่เฉพาะเจาะจงหมดสต็อก Menu การอัปเดตที่เพิ่มขึ้น: ส่ง Menu สรุป ตั้งค่าเอนทิตีที่มี offer.inventoryLevel เป็น 0 สำหรับ MenuItem และข้อมูลอื่นๆ ทั้งหมดไม่เปลี่ยนแปลง
การเปลี่ยนแปลงราคาของรายการในเมนู Menu การอัปเดตที่เพิ่มขึ้น: ส่ง Menu สรุป ตั้งค่าเอนทิตีที่มี offer.price เป็นราคาที่อัปเดตแล้วสำหรับ MenuItem และข้อมูลอื่นๆ ทั้งหมดไม่เปลี่ยนแปลง

เพิ่มเอนทิตีระดับบนสุดใหม่

ใช้ได้กับเอนทิตีประเภท Menu เท่านั้น Restaurant และ Service

Menu, Restaurant, Service

เช่น คุณต้องเพิ่มเมนูใหม่ให้ร้านอาหาร

การอัปเดตเพิ่มเติม: ส่งเอนทิตีเมนูใหม่พร้อมกับร้านอาหาร เอนทิตีที่มีฟิลด์ hasMenu จะได้รับการอัปเดตตามนั้น

ลบเอนทิตีระดับบนสุดอย่างถาวร

ใช้ได้กับเอนทิตีประเภท 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 ที่เพิ่มขึ้นเพื่อให้สินค้าคงคลังของคุณเป็นปัจจุบัน