การนำเข้าแบบเป็นกลุ่ม

ฟีดข้อมูลช่วยให้คุณแสดงร้านอาหาร บริการ และเมนูใน "การสั่งอาหารจากต้นทางถึงปลายทาง" ได้

เอกสารนี้อธิบายวิธีโฮสต์พื้นที่ทรายและสินค้าคงคลังเวอร์ชันที่ใช้งานจริง รวมถึงการใช้การส่งผ่านข้อมูลแบบเป็นกลุ่มเพื่ออัปเดตสินค้าคงคลังในการสั่งซื้อจากต้นทางถึงปลายทาง

สภาพแวดล้อมฟีดข้อมูล

สภาพแวดล้อมฟีดข้อมูลสําหรับการพัฒนาการผสานรวมมี 3 ประเภทดังนี้

สภาพแวดล้อมของฟีด คำอธิบาย การนำเข้าแบบเป็นกลุ่ม
แซนด์บ็อกซ์ สภาพแวดล้อมการทดสอบสําหรับการพัฒนาฟีด ต้องระบุ
เวอร์ชันที่ใช้งานจริง สภาพแวดล้อมเวอร์ชันที่ใช้งานจริงสำหรับพื้นที่โฆษณาที่ต้องการเปิดตัว ต้องระบุ

โฮสติ้งฟีดข้อมูล

หากต้องการให้การสั่งซื้อแบบครบวงจรประมวลผลฟีดข้อมูลใน Sandbox และเวอร์ชันที่ใช้งานจริงโดยการนำเข้าแบบเป็นกลุ่ม คุณต้องโฮสต์ไฟล์ฟีดข้อมูลใน Google Cloud Storage, Amazon S3 หรือ HTTPS ที่มี Sitemap

เราขอแนะนําให้โฮสต์ฟีดข้อมูลสําหรับสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงแยกกัน วิธีนี้ช่วยให้คุณพัฒนาและทดสอบในสภาพแวดล้อมฟีดแซนด์บ็อกซ์ได้ก่อนที่จะนำการเปลี่ยนแปลงไปใช้กับเวอร์ชันที่ใช้งานจริง

ตัวอย่างเช่น หากคุณใช้ Google Cloud Storage เป็นตัวเลือกโฮสติ้ง คุณจะมีเส้นทางต่อไปนี้

  • ฟีดแซนด์บ็อกซ์: gs://foorestaurant-google-feed-sandbox/
  • ฟีดเวอร์ชันที่ใช้งานจริง: gs://foorestaurant-google-feed-prod/

หากต้องการโฮสต์พื้นที่โฆษณา ให้ทําดังนี้

  1. สร้างไฟล์ฟีดข้อมูล
  2. เลือกโซลูชันโฮสติ้ง
  3. โฮสต์ฟีดข้อมูล
  4. ตรวจสอบว่าไฟล์ฟีดข้อมูลได้รับการอัปเดตเป็นประจำ ฟีดข้อมูลเวอร์ชันที่ใช้งานจริงต้องอัปเดตทุกวัน

ดูรายละเอียดเกี่ยวกับวิธีสร้างฟีดสินค้าคงคลังได้ที่เอกสารประกอบสำหรับเอนทิตี Restaurant, Service และ Menu รวมถึงส่วนสร้างฟีดข้อมูล

หลักเกณฑ์เกี่ยวกับไฟล์ฟีดข้อมูล

แต่ละไฟล์ซึ่งมีเอนทิตีหลายรายการต้องมีขนาดไม่เกิน 200 MB เอนทิตีระดับบนสุด Restaurant, Service และ Menu รวมถึงเอนทิตีย่อยต้องไม่เกิน 4 MB รวมกัน

เลือกโซลูชันโฮสติ้ง

ตารางต่อไปนี้แสดงตัวเลือกสำหรับการโฮสต์ฟีดข้อมูลและวิธีที่โฮสต์เหล่านั้นทำงานร่วมกับการสั่งซื้อตั้งแต่ต้นจนจบ

Amazon S3 Google Cloud Storage HTTPS ที่มี Sitemap
ข้อมูลเข้าสู่ระบบและการเข้าถึง

ระบุข้อมูลต่อไปนี้ให้ Google

  • รหัสคีย์การเข้าถึง
  • คีย์การเข้าถึงข้อมูลลับ
  • เส้นทางไปยังไดเรกทอรี S3 ของเวอร์ชันที่ใช้งานจริงและของแท็บทดลองใช้ และไฟล์ marker.txt เส้นทางต้องขึ้นต้นด้วย s3://

ที่เก็บข้อมูล S3 ต้องมีข้อมูลต่อไปนี้

  • ไฟล์ฟีดสำหรับพื้นที่โฆษณา
  • marker.txt ซึ่งมีการประทับเวลาที่ใช้สำหรับการดึงข้อมูล

ตัวอย่างไฟล์ marker.txt: 2018-12-03T08:30:42.694Z

ระบุเส้นทางไปยังไดเรกทอรีที่เก็บข้อมูลเวอร์ชันที่ใช้งานจริงและที่เก็บข้อมูลจำลอง รวมถึงไฟล์ marker.txt ให้กับ Google เส้นทางต้องขึ้นต้นด้วย gs://

เพิ่มบัญชีบริการที่ได้จากที่ปรึกษาของ Google เป็นผู้อ่านที่เก็บข้อมูล Google Cloud Storage

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีควบคุมการเข้าถึง Google Cloud Storage (GCS) ได้ที่คอนโซล Google Cloud Platform: การตั้งค่าสิทธิ์ของที่เก็บข้อมูล

ที่เก็บข้อมูล GCS ต้องมีข้อมูลต่อไปนี้

  • ไฟล์ฟีดสำหรับพื้นที่โฆษณา
  • marker.txt ซึ่งมีการประทับเวลาที่ใช้สำหรับการดึงข้อมูล

ตัวอย่างไฟล์ marker.txt: 2018-12-03T08:30:42.694Z

ระบุข้อมูลต่อไปนี้ให้ Google

  • ข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์พื้นฐาน
  • เส้นทางไปยังเส้นทาง sitemap ของเวอร์ชันที่ใช้งานจริงและแซนด์บ็อกซ์ เส้นทางต้องขึ้นต้นด้วย https://
  • โปรโตคอล: คุณต้องทำให้ไฟล์ฟีดพร้อมใช้งานผ่าน HTTPS ไม่ใช่ HTTP
  • ความปลอดภัย: Google ขอแนะนําอย่างยิ่งให้คุณปกป้องไฟล์ฟีดที่โฮสต์ด้วยการตรวจสอบสิทธิ์พื้นฐาน
วิธีที่ Google รู้ว่าต้องดึงข้อมูลไฟล์ใด รายการไดเรกทอรีของไฟล์ทั้งหมดในที่เก็บข้อมูล รายการไดเรกทอรีของไฟล์ทั้งหมดในที่เก็บข้อมูล URL ของไฟล์แต่ละรายการที่แสดงในSitemap
วิธีที่ Google ทราบว่าไฟล์พร้อมให้ดึงข้อมูลแล้ว หลังจากสร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตไฟล์ marker.txt ด้วยการประทับเวลาล่าสุด หลังจากสร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตไฟล์ marker.txt ด้วยการประทับเวลาล่าสุด หลังจากสร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตส่วนหัวของคำตอบ last-modified ของ sitemap.xml ด้วยการประทับเวลาล่าสุด
ขีดจำกัดของไฟล์

จำนวนไฟล์สูงสุด: 100,000 ไฟล์

คุณต้องมีไฟล์ทั้งหมดไม่เกิน 100,000 ไฟล์ในที่เก็บข้อมูล Amazon S3

จำนวนไฟล์สูงสุด: 100,000 ไฟล์

คุณต้องมีไฟล์ทั้งหมดน้อยกว่า 100,000 ไฟล์ในที่เก็บข้อมูล Google Cloud Storage

จำนวนไฟล์สูงสุด: 100,000 ไฟล์

จำนวนเส้นทางไฟล์ภายในไฟล์ XML ของ Sitemap ต้องน้อยกว่า 100,000 รายการ

เชื่อมต่อฟีดข้อมูลสำหรับการนำเข้าแบบเป็นกลุ่ม

หลังจากโฮสต์ฟีดแล้ว คุณต้องเชื่อมต่อฟีดกับโปรเจ็กต์ใน Actions Center การกําหนดค่าเริ่มต้นของฟีดเวอร์ชันที่ใช้งานจริงจะทําในหน้างานเริ่มต้นใช้งาน ภายหลังผู้ใช้พอร์ทัลที่มีบทบาทผู้ดูแลระบบจะอัปเดตการกำหนดค่าฟีดเวอร์ชันที่ใช้งานจริงและฟีดแซนด์บ็อกซ์ได้จากหน้าการกําหนดค่า > ฟีดได้ทุกเมื่อ สภาพแวดล้อมเสมือนจริงมีไว้เพื่อการพัฒนาและการทดสอบ ส่วนฟีดเวอร์ชันที่ใช้งานจริงจะแสดงต่อผู้ใช้

หากคุณโฮสต์ฟีดข้อมูลด้วย Amazon S3

  1. ในศูนย์การดำเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไข แล้วกรอกแบบฟอร์มอัปเดตฟีด

    • วิธีการส่งฟีด: ตั้งค่าเป็น Amazon S3
    • ไฟล์เครื่องหมาย: ระบุ URL ของไฟล์ marker.txt
    • ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล S3 ที่มีฟีดข้อมูล
    • รหัสการเข้าถึง: ป้อนรหัสคีย์การเข้าถึง IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
    • คีย์การเข้าถึง: ป้อนคีย์การเข้าถึงลับของ IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
  3. คลิกส่ง
  4. หลังจากผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบเป็นกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

หากคุณโฮสต์ฟีดข้อมูลด้วย Google Cloud Storage

  1. ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไข แล้วกรอกแบบฟอร์มอัปเดตฟีด

    • วิธีการส่งฟีด: ตั้งค่าเป็น Google Cloud Storage
    • ไฟล์เครื่องหมาย: ระบุ URL ของไฟล์ marker.txt
    • ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล GCS ที่มีฟีดข้อมูล
  3. คลิกส่ง
  4. ระบบจะสร้างบัญชีบริการเพื่อเข้าถึงที่เก็บข้อมูล GCS คุณจะเห็นชื่อบัญชีในส่วนการกําหนดค่า > ฟีดหลังจากงานเริ่มต้นใช้งานเสร็จสมบูรณ์ บัญชีบริการนี้ต้องมีบทบาท "Storage Legacy Object Reader" คุณสามารถมอบบทบาทนี้ให้กับบัญชีบริการได้ในหน้า IAM ของ Google Cloud Console
  5. หลังจากผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบเป็นกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

หากคุณโฮสต์ฟีดข้อมูลด้วย HTTPS

  1. ในศูนย์การดำเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไข แล้วกรอกแบบฟอร์มอัปเดตฟีด

    • วิธีการส่งฟีด: ตั้งค่าเป็น HTTPS
    • ไฟล์ Sitemap: ระบุ URL ของไฟล์ sitemap.xml
    • ชื่อผู้ใช้: ป้อนข้อมูลเข้าสู่ระบบชื่อผู้ใช้เพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
    • รหัสผ่าน: ป้อนรหัสผ่านเพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
  3. คลิกส่ง
  4. หลังจากผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบเป็นกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

ตัวอย่างเส้นทาง

ตารางต่อไปนี้แสดงตัวอย่างเส้นทางสำหรับตัวเลือกการโฮสต์แต่ละรายการ

Amazon S3 Google Cloud Storage HTTPS ที่มี Sitemap
เส้นทาง s3://foorestaurant-google-feed-sandbox/ gs://foorestaurant-google-feed-sandbox/ https://sandbox-foorestaurant.com/sitemap.xml
ไฟล์เครื่องหมาย s3://foorestaurant-google-feed-sandbox/marker.txt gs://foorestaurant-google-feed-sandbox/marker.txt ไม่เกี่ยวข้อง

Sitemap สําหรับโฮสติ้ง HTTPS

ใช้หลักเกณฑ์ต่อไปนี้เมื่อกำหนด Sitemap

  • ลิงก์ใน Sitemap ต้องชี้ไปยังไฟล์นั้นๆ
  • หาก Sitemap มีการอ้างอิงถึงผู้ให้บริการระบบคลาวด์แทนชื่อโดเมนของคุณเอง ให้ตรวจสอบว่า URL ขึ้นต้น เช่น https://www.yourcloudprovider.com/your_id มีความเสถียรและไม่ซ้ำกันสำหรับงานแบบเป็นกลุ่ม
  • โปรดระวังอย่าอัปโหลด Sitemap เพียงบางส่วน (เช่น ในกรณีที่มีการอัปโหลดข้อมูลเพียงบางส่วน) ซึ่งจะทำให้ Google นำเข้าเฉพาะไฟล์ใน Sitemap ซึ่งจะทำให้ระดับพื้นที่โฆษณาลดลงและอาจส่งผลให้การนำเข้าฟีดถูกบล็อก
  • ตรวจสอบว่าเส้นทางไปยังไฟล์ที่อ้างอิงใน Sitemap ไม่ได้เปลี่ยนแปลง เช่น อย่าให้ Sitemap อ้างอิง https://www.yourcloudprovider.com/your_id/10000.json ในวันนี้ แต่อ้างอิง https://www.yourcloudprovider.com/your_id/20000.json ในวันถัดไป
ตัวอย่างแผนผังเว็บไซต์

ต่อไปนี้คือตัวอย่างไฟล์ sitemap.xml ที่แสดงไฟล์ฟีดข้อมูล

ตัวอย่างที่ 1: เอนทิตีที่จัดกลุ่มตามผู้ขาย (แนะนำ)

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

ตัวอย่างที่ 2: เอนทิตีที่จัดกลุ่มตามประเภท

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

อัปเดตฟีดข้อมูล

หลังจากเชื่อมต่อฟีดข้อมูลแล้ว Google จะตรวจสอบการอัปเดตทุกชั่วโมง แต่เราจะนำเข้าฟีดข้อมูลทั้งหมดก็ต่อเมื่อมีการเปลี่ยนแปลงไฟล์ marker.txt หรือ sitemap.xml เราคาดหวังให้คุณอัปเดตฟีดข้อมูลวันละครั้งเพื่อป้องกันไม่ให้สินค้าคงคลังล้าสมัย

หากต้องการระบุว่าฟีดข้อมูลได้รับการแก้ไขและพร้อมสำหรับการนำเข้าแบบเป็นกลุ่ม ให้อัปเดตlast-modifiedช่องข้อมูลเมตาออบเจ็กต์ของไฟล์ marker.txt (สำหรับ GCP และ S3) หรือส่วนหัวการตอบกลับ last-modified ของไฟล์ sitemap.xml Google ใช้ค่าเหล่านี้เพื่อพิจารณาความใหม่ของฟีดข้อมูล

ขณะส่งผ่านข้อมูลฟีดแบบเป็นกลุ่ม

  • ระบบจะแทรกเอนทิตีใหม่ที่ไม่มีอยู่ในคลังสินค้าจากต้นทางถึงปลายทางสำหรับการสั่งซื้อปัจจุบันและไม่มีข้อผิดพลาด
  • เอนทิตีที่มีอยู่แล้วในคลังสินค้าซึ่งไม่มีข้อผิดพลาดในการนำเข้า และมี dateModified ที่ใหม่กว่ารายการปัจจุบัน หรือในกรณีที่ไม่มี dateModified เวลาเริ่มต้นการนำเข้าฟีดจะใหม่กว่ารายการปัจจุบัน ระบบจะอัปเดตเอนทิตีดังกล่าว ไม่เช่นนั้นระบบจะทำเครื่องหมายว่าเอนทิตีนั้นล้าสมัย
  • ระบบจะลบเอนทิตีที่เป็นส่วนหนึ่งของฟีดก่อนหน้าซึ่งไม่รวมอยู่ในฟีดกลุ่มที่ประมวลผลแล้ว เว้นแต่ว่าจะไม่มีข้อผิดพลาดระดับไฟล์ในฟีด

ต้องอัปเดตการประทับเวลาหรือส่วนหัวคำตอบ last-modified หลังจากที่สร้างและอัปเดตไฟล์ฟีดข้อมูลทั้งหมดแล้วเท่านั้น จำกัดงานกลุ่มที่อัปเดตฟีดข้อมูลให้ทำงานวันละครั้งเท่านั้น หรือเว้นระยะเวลาอย่างน้อย 3 ชั่วโมงระหว่างการเรียกใช้แต่ละชุด หากไม่ทำตามขั้นตอนเหล่านี้ Google อาจดึงข้อมูลไฟล์ที่ล้าสมัย

ก่อนหน้า
ทดสอบฟีดข้อมูล